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

The query root

The identifier for the request

Example

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

    Parameters

    Root

    The query root

    DataSet

    The identifier for the request

    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()) {    
           // Add the SOP Class UID(s) that you expect to receive to the Presentation Contexts
           cn.RequestedContexts.Add(SOPClasses.StudyRootQR_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
           
           cn.Get(QueryRoot.Study, request); // send C-GET request
           
           // all images retrieved can be found here 
           DicomDataSetCollection instances = cn.ReturnedInstances;
                
           cn.Close();
       }
    Requirements

    Target Platforms: .NET CLR 4.8 or higher

    See Also