TreeNodeCollection.Contains(TreeNode) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bestimmt, ob der angegebene Strukturknoten ein Member der Auflistung ist.

public:
 bool Contains(System::Windows::Forms::TreeNode ^ node);

public bool Contains (System.Windows.Forms.TreeNode node);

member this.Contains : System.Windows.Forms.TreeNode -> bool

Public Function Contains (node As TreeNode) As Boolean

Parameter

node: TreeNode

Die TreeNode, die in der Auflistung gesucht werden soll.

Gibt zurück

Boolean

true, wenn das TreeNode ein Member der Auflistung ist, andernfalls false.

Beispiele

Im folgenden Codebeispiel wird bestimmt, ob sich ein angegebenes TreeNode innerhalb eines TreeNodeCollectionbefindet, und listet dann die Auflistung auf. Dieses Beispiel erfordert, dass Sie über ein Form mit einem TreeView verfügen, das einen TreeNodeCollection enthält, der einen TreeNode namens myTreeNode2enthält.

void EnumerateTreeNodes()
{
   TreeNodeCollection^ myNodeCollection = myTreeView->Nodes;

   // Check for a node in the collection.
   if ( myNodeCollection->Contains( myTreeNode2 ) )
   {
      myLabel->Text = myLabel->Text + "Node2 is at index: " + myNodeCollection->IndexOf( myTreeNode2 );
   }

   myLabel->Text = myLabel->Text + "\n\nElements of the TreeNodeCollection:\n";

   // Create an enumerator for the collection.
   IEnumerator^ myEnumerator = myNodeCollection->GetEnumerator();
   while ( myEnumerator->MoveNext() )
   {
      myLabel->Text = myLabel->Text + (dynamic_cast<TreeNode^>(myEnumerator->Current))->Text + "\n";
   }
}

private void EnumerateTreeNodes()
{
   TreeNodeCollection myNodeCollection = myTreeView.Nodes;
   // Check for a node in the collection.
   if (myNodeCollection.Contains(myTreeNode2))
   {
      myLabel.Text += "Node2 is at index: " + myNodeCollection.IndexOf(myTreeNode2);
   }
   myLabel.Text += "\n\nElements of the TreeNodeCollection:\n";

   // Create an enumerator for the collection.
   IEnumerator myEnumerator = myNodeCollection.GetEnumerator();
   while(myEnumerator.MoveNext())
   {
      myLabel.Text += ((TreeNode)myEnumerator.Current).Text +"\n";
   }
}

Private Sub EnumerateTreeNodes()
   Dim myNodeCollection As TreeNodeCollection = myTreeView.Nodes
   ' Check for a node in the collection.
   If myNodeCollection.Contains(myTreeNode2) Then
      myLabel.Text += "Node2 is at index: " + myNodeCollection.IndexOf(myTreeNode2)
   End If
   myLabel.Text += ControlChars.Cr + ControlChars.Cr + _
     "Elements of the TreeNodeCollection:" + ControlChars.Cr
   
   ' Create an enumerator for the collection.
   Dim myEnumerator As IEnumerator = myNodeCollection.GetEnumerator()
   While myEnumerator.MoveNext()
      myLabel.Text += CType(myEnumerator.Current, TreeNode).Text + ControlChars.Cr
   End While
End Sub

Hinweise

Mit dieser Methode können Sie bestimmen, ob ein TreeNode Mitglied der Auflistung ist, bevor Sie versuchen, Vorgänge für auszuführen TreeNode. Sie können diese Methode verwenden, um zu bestätigen, dass ein TreeNode -Element der Auflistung hinzugefügt wurde oder noch mitglied ist.

Die Dauer dieser Methode ist proportional zur Größe der Knotenauflistung. Daher sollten Sie die Verwendung mit großen Auflistungen vermeiden.

Diese Methode überprüft nur auf Verweisgleichheit. Sie können nicht verwenden, um zu bestimmen, ob sich ein gleichwertiger, aber anderer Knoten in der Auflistung befindet.

Hinweis

Eine Folge der Verweisgleichheitsanforderung ist, dass Sie das Verhalten dieser Methode nicht für abgeleitete TreeNode Typen anpassen können, indem Sie die Equals -Methode der TreeNode -Klasse überschreiben.

Gilt für:

Freigeben über