DicomObjects.NET.8.48 Documentation
DicomObjects.DicomWeb.WebClient Namespace / WadoWebClient Class / RetrieveMetaData Method
The Requested StudyUID
The Requested series UID (may be null/absent)
The Requested instance UID (may be null/absent)






In This Topic
    RetrieveMetaData Method
    In This Topic
    Retrieve DICOM instances without their large data elements (so-called metadata), based on explicit study, series and instance UIDs
    Syntax
    'Declaration
     
    
    Public Function RetrieveMetaData( _
       ByVal StudyUID As System.String, _
       Optional ByVal SeriesUID As System.String, _
       Optional ByVal InstanceUID As System.String _
    ) As DicomDataSetCollection
    'Usage
     
    
    Dim instance As WadoWebClient
    Dim StudyUID As System.String
    Dim SeriesUID As System.String
    Dim InstanceUID As System.String
    Dim value As DicomDataSetCollection
     
    value = instance.RetrieveMetaData(StudyUID, SeriesUID, InstanceUID)
    public DicomDataSetCollection RetrieveMetaData( 
       System.string StudyUID,
       System.string SeriesUID,
       System.string InstanceUID
    )
    public function RetrieveMetaData( 
        StudyUID: System.String;
        SeriesUID: System.String;
        InstanceUID: System.String
    ): DicomDataSetCollection; 
    public function RetrieveMetaData( 
       StudyUID : System.String,
       SeriesUID : System.String,
       InstanceUID : System.String
    ) : DicomDataSetCollection;
    public: DicomDataSetCollection* RetrieveMetaData( 
       System.string* StudyUID,
       System.string* SeriesUID,
       System.string* InstanceUID
    ) 
    public:
    DicomDataSetCollection^ RetrieveMetaData( 
       System.String^ StudyUID,
       System.String^ SeriesUID,
       System.String^ InstanceUID
    ) 

    Parameters

    StudyUID
    The Requested StudyUID
    SeriesUID
    The Requested series UID (may be null/absent)
    InstanceUID
    The Requested instance UID (may be null/absent)

    Return Value

    Set of Dicom Instances transformed from the json or xml
    Remarks

    This is intended to getting a "quick overview" of instances before getting them fully, but if the instances are "used" (e.g. by viewing or writing out), then DicomObjects will automatically retrieve any "missing" data as required via individual bulk data retrieval calls. WHilst efficient for one or two elements (perhaps one frame of an image), if the whole instance is needed, then it is more efficient either to retrieve in native form, or to add all the bulk data items in one go via AppendBulkData .

    Requirements

    Target Platforms: .NET CLR 4.8 or higher

    See Also