QueryAsync Method (WorkItemWebClient)

In This Topic

Asychronous operation to issue a WorkItems query

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<AsyncStateMachineAttribute(DicomObjects.DicomWeb.WorkItemWebClient/d__26)> 
Public Function QueryAsync( _ 
   ByVal QueryDataSet As DicomDataSet, _ 
   Optional ByVal cancellationToken As CancellationToken _ 
) As Task(Of DicomDataSetCollection)

'Usage
 
Dim instance As WorkItemWebClient
Dim QueryDataSet As DicomDataSet
Dim cancellationToken As CancellationToken
Dim value As Task(Of DicomDataSetCollection)
 
value = instance.QueryAsync(QueryDataSet, cancellationToken)

[AsyncStateMachine(DicomObjects.DicomWeb.WorkItemWebClient/d__26)] 
public Task<DicomDataSetCollection> QueryAsync( 
   DicomDataSet QueryDataSet, 
   CancellationToken cancellationToken 
)

[AsyncStateMachine(DicomObjects.DicomWeb.WorkItemWebClient/d__26)] 
public: 
Task<DicomDataSetCollection^>^ QueryAsync( 
   DicomDataSet^ QueryDataSet, 
   CancellationToken cancellationToken 
)

Parameters

QueryDataSet: The dataset which defines the query - equivalent to that used or generated by a DicomObjects.DicomQuery
cancellationToken: A token that may be used to cancel the operation

Return Value

The workitem responses coded into a object

Remarks

The async operation will return as soon as the response is available and headers are read (content is not read yet)

Example

this example mimics the IHE-RO UPS query request

WorkItemWebClient wwc = new WorkItemWebClient(BaseUri);        
DicomDataSet queryDS = new DicomDataSet()
   {
     { Keyword.SOPInstanceUID, "" },
     { Keyword.PatientID, "" },
     { Keyword.StudyInstanceUID, "" },
     { Keyword.ScheduledProcedureStepStartDate, "2022/07/01" },
     { Keyword.InputReadinessState, "" },
     { Keyword.ProcedureStepState, "SCHEDULED" },
     { Keyword.ScheduledProcedureStepPriority, "" },
     { Keyword.WorklistLabel, "" },
     { Keyword.ProcedureStepLabel, "" },
     { Keyword.ScheduledProcessingParametersSequence, "" },
     { Keyword.InputInformationSequence, ""},
     { Keyword.ScheduledWorkitemCodeSequence, ""}
   };
DicomDataSetCollection stationNameCodeSequence = new DicomDataSetCollection();
DicomDataSet sqItem = new DicomDataSet
   {
       { Keyword.CodeValue, "station 1" },
       { Keyword.CodingSchemeDesignator, "DCM" }
   };
stationNameCodeSequence.Add(sqItem);
queryDS.Add(Keyword.ScheduledStationNameCodeSequence, stationNameCodeSequence);
   var results = wwc.Query(queryDS);

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

Reference

WorkItemWebClient Class
WorkItemWebClient Members
DicomDataSetCollection Class

Send Feedback