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

In This Topic
    RetrieveMetaDataAsync Method
    In This Topic
    Async Retrieve DICOM instances without their large data elements (so-called metadata), based on explicit study, series and instance UIDs
    Syntax
    'Declaration
     
    
    <System.Runtime.CompilerServices.AsyncStateMachineAttribute(DicomObjects.DicomWeb.WebClient.WadoWebClient/d__10)> 
    Public Function RetrieveMetaDataAsync( _ 
       ByVal StudyUID As System.String, _ 
       Optional ByVal SeriesUID As System.String, _ 
       Optional ByVal InstanceUID As System.String _ 
    ) As System.Threading.Tasks.Task(Of DicomDataSetCollection)
    [System.Runtime.CompilerServices.AsyncStateMachine(DicomObjects.DicomWeb.WebClient.WadoWebClient/d__10)] 
    public System.Threading.Tasks.Task<DicomDataSetCollection> RetrieveMetaDataAsync( 
       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