DicomObjects.NET.8.48 Documentation
DicomObjects Namespace / DicomAssociation Class / Get Method / Get(QueryRoot,DicomDataSet,Boolean) Method

The query root

The identifier for the request

Specify if bulk data is required in the response

Example

In This Topic
    Get(QueryRoot,DicomDataSet,Boolean) Method
    In This Topic
    Sends a C-GET request
    Syntax
    'Declaration
     
    
    Public Overloads Sub Get( _
       ByVal Root As QueryRoot, _
       ByVal DataSet As DicomDataSet, _
       ByVal NoBulkData As System.Boolean _
    ) 
    public void Get( 
       QueryRoot Root,
       DicomDataSet DataSet,
       System.bool NoBulkData
    )

    Parameters

    Root

    The query root

    DataSet

    The identifier for the request

    NoBulkData

    Specify if bulk data is required in the response

    Remarks

    The images to be retrieved are defined by the DataSet parameter.

    Note that the QueryLevel value (0008,0052), must be included in the data set, but the dataset parameter MUST NOT contain any group 0x0000 elements (the group 0x0000 contains elements describing operation and some of the fields like MessageID, etc.)

    Once the operation has completed, the images retrieved may be found in the ReturnedInstances collection.

    Example
    using DicomObjects;
    using DicomObjects.DicomUIDs;
    using DicomObjects.Enums;
                	    
       using (var cn = new DicomAssociation()) {    
           var NoBulkData = true;
               
           // Add the SOP Class UID(s) that you expect to receive to the Presentation Contexts
           cn.RequestedContexts.Add(SOPClasses.CompositeInstanceRootRetrieveWithoutBulkData_GET);
           cn.RequestedContexts.Add(SOPClasses.CT);      
           cn.Open("localhost", 104, "callingAET", "calledAET");    
           
           var request = new DicomDataSet();
           request.PatientID = "222.22.2222";
           request.StudyUID = "999.999.2.19941105.112000";
           request.SeriesUID = "1.2.826.0.1.3680043.4.1.19990124221049.3";
           request.InstanceUID = "1.2.826.0.1.3680043.4.1.19990124230602.1";
           request.Add(Keyword.QueryRetrieveLevel, "INSTANCE"); // Image/Instance level C-GET
           
           // NoBulkData applies only when QueryRoot is set to CompositeInstance
           cn.Get(QueryRoot.CompositeInstance, request, NoBulkData); 
           
           // all images retrieved can be found here 
           DicomDataSetCollection instances = cn.ReturnedInstances;
                
           cn.Close();
       }
    Requirements

    Target Platforms: .NET CLR 4.8 or higher

    See Also