Overloads Public Function FindFirstKey( _
   ByVal element As DicomElement, _
   ByVal key As String, _
   ByVal tree As Boolean _
) As DicomElement

Visual Basic (Usage)	Copy Code
Dim instance As DicomDataSet Dim element As DicomElement Dim key As String Dim tree As Boolean Dim value As DicomElement   value = instance.FindFirstKey(element, key, tree)

public DicomElement FindFirstKey( 
   DicomElement element,
   string key,
   bool tree
)

public:
DicomElement^ FindFirstKey( 
   DicomElement^ element,
   String^ key,
   bool tree
) 

Parameters

element

An item in the Data Set.

key

The type of key element to find.

tree

true to evaluate the Data Set as a tree; false to evaluate the Data Set as a list.

Return Value

If the Data Set is evaluated as a tree structure, this method returns the first item on the same level as element with the same parent as element, that has key element type key.

Please note that the numbering of the items of interest in this first illustration is arbitrary and does not imply order.

If the Data Set is evaluated as a list, this method returns the first item in the entire list that has key element type key. The search begins at the top of the list.

Please note that the numbering of the items in the following illustration does indicate the order of the items when the Data Set is evaluated as a list.

The following methods will also help you find elements in the Data Set with a specific key element type:

FindLastKey

FindPreviousKey

FindNextKey

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

Reference