'Declaration
 
Public Function MakeQuery( _
   ByVal UseInstanceRoot As System.Boolean _
) As DicomQuery

public DicomQuery MakeQuery( 
   System.bool UseInstanceRoot
)

Parameters

UseInstanceRoot

If true, and if appropriate, then the Compoosite Instance root and frame level retrieve are used

Return Value

This query object can be used for a C-GET (DicomObjects.DicomQuery.Get) or C-MOVE ( DicomObjects.DicomQuery.Move) but other properties such as Node, Port and the AETs must be completed before it is used.

If the request is for instance or frame level and UseInstanceRoot is true, then the root will be set to DicomObjects.Enums.QueryRoot.CompositeInstance and DicomObjects.DicomQuery.Level will be set to DicomObjects.Enums.QueryLevel.FRAME if appropriate but if not, then then only study, series and instance levels will be used, with the study instance. The choice of whether to use this parameter (which can make frame level queries much more efficient) depends on the support for Composite Instance Root in the server.

If UseInstanceRoot has been set to true, then FramesReduced should be set to true in the ReturnData(IEnumerable<DicomDataSet>,Boolean) method as only the requested frames would be returned by a query based on this object.

Target Platforms: .NET CLR 4.8 or higher