DicomObjects.NET8 Documentation
DicomObjects.DicomWeb Namespace / WadoEventArgs Class / MakeQuery Method
If true, and if appropriate, then the Compoosite Instance root and frame level retrieve are used



In This Topic
    MakeQuery Method
    In This Topic
    Create a DicomQuery object to reflect the WADO-RS request
    Syntax
    'Declaration
     
    
    Public Function MakeQuery( _
       ByVal UseInstanceRoot As Boolean _
    ) As DicomQuery
    'Usage
     
    
    Dim instance As WadoEventArgs
    Dim UseInstanceRoot As Boolean
    Dim value As DicomQuery
     
    value = instance.MakeQuery(UseInstanceRoot)
    public DicomQuery MakeQuery( 
       bool UseInstanceRoot
    )
    public:
    DicomQuery^ MakeQuery( 
       bool UseInstanceRoot
    ) 

    Parameters

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

    Return Value

    A DicomQuery object
    Remarks

    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 method as only the requested frames would be returned by a query based on this object.

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also