GetDicomDataSets(MatchingParameterCollection) Method

Summary

Retrieves a list of DicomDataSet that matches query parameters specified in a MatchingParameterCollection from the storage source.

Syntax

C++

public List<DicomDataSet> GetDicomDataSets( 
   MatchingParameterCollection matchingCollection 
)

Public Function GetDicomDataSets( 
   ByVal matchingCollection As MatchingParameterCollection 
) As List(Of DicomDataSet)

public:  
   List<DicomDataSet^>^ GetDicomDataSets( 
      MatchingParameterCollection^ matchingCollection 
   )

Parameters

matchingCollection

A MatchingParameterCollection which includes the matching parameters for a query.

Return Value

A List of DicomDataSet that corresponds to the query parameters specified in MatchingParameterCollection.

If no such DicomDataSet exists, an empty List is returned.

Remarks

The MatchingParameterCollection can contain one or more MatchingParameterList.

Each MatchingParameterList can contain one or more ICatalogEntity.

For example, to create a MatchingParameterCollection to search for all instances of a particular PatientID, do the following:

string patientId = "12341234"; 
MatchingParameterCollection matchingCollection = new MatchingParameterCollection(); 
MatchingParameterList matchingList = new MatchingParameterList(); 
matchingCollection.Add(matchingList); 
ICatalogEntity patientEntity = RegisteredEntities.GetPatientEntity(patientId); 
matchingList.Add(patientEntity);