TreeNodeCollection.Contains(TreeNode) TreeNodeCollection.Contains(TreeNode) TreeNodeCollection.Contains(TreeNode) TreeNodeCollection.Contains(TreeNode) Method

Definition

Bestimmt, ob der angegebene Strukturknoten ein Member der Auflistung ist.Determines whether the specified tree node is a member of the collection.

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 TreeNode TreeNode TreeNode

Die TreeNode, die in der Auflistung gesucht werden soll.The TreeNode to locate in the collection.

Gibt zurück

true, wenn das TreeNode ein Member der Auflistung ist, andernfalls false.true if the TreeNode is a member of the collection; otherwise, false.

Beispiele

Im folgenden Codebeispiel wird festgelegt TreeNode , ob ein angegebenes innerhalb eines TreeNodeCollectionist, und anschließend wird die Auflistung aufgelistet.The following code example determines if a specified TreeNode is within a TreeNodeCollection, and then enumerates the collection. Für dieses Beispiel ist es erforderlich, Form dass über TreeView ein mit einem TreeNodeCollection verfügt, das TreeNode einen myTreeNode2mit dem Namen enthält.This example requires that you have a Form with a TreeView that has a TreeNodeCollection that contains a TreeNode named myTreeNode2.

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 TreeNode ein ein Member der Auflistung ist, bevor Sie versuchen, Vorgänge TreeNodefür auszuführen.This method enables you to determine whether a TreeNode is a member of the collection before attempting to perform operations on the TreeNode. Mit dieser Methode können Sie überprüfen, ob TreeNode eine hinzugefügt wurde oder noch ein Member der Auflistung ist.You can use this method to confirm that a TreeNode has been added to or is still a member of the collection.

Die von dieser Methode benötigte Zeit ist proportional zur Größe der Knoten Auflistung. Sie sollten Sie daher vermeiden, Sie mit großen Auflistungen zu verwenden.The amount of time this method takes is proportional to the size of the node collection, so you may want to avoid using it with large collections.

Diese Methode überprüft nur Verweis Gleichheit.This method checks for reference equality only. Sie können Sie nicht verwenden, um zu bestimmen, ob ein entsprechender, aber ein anderer Knoten in der Auflistung ist.You cannot use it to determine whether an equivalent but different node is in the collection.

Hinweis

Eine Implikation der Verweis Gleichheits Anforderung besteht darin, dass Sie das Verhalten dieser Methode für abgeleitete TreeNode Typen nicht anpassen können Equals , indem Sie TreeNode die-Methode der-Klasse überschreiben.One implication of the reference-equality requirement is that you cannot customize the behavior of this method for derived TreeNode types by overriding the Equals method of the TreeNode class.

Gilt für: