TreeNodeCollection.Contains(TreeNode) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Détermine si le nœud d'arbre spécifié est un membre de la 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

Paramètres

node

TreeNode

TreeNode à rechercher dans la collection.

Retours

Boolean

true si TreeNode est membre de la collection ; sinon, false.

Exemples

L’exemple de code suivant détermine si un élément spécifié TreeNode se trouve dans un TreeNodeCollection, puis énumère la collection. Cet exemple nécessite que vous ayez un Form avec un TreeView qui contient un TreeNodeCollection TreeNode nommé 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

Remarques

Cette méthode vous permet de déterminer si un TreeNode membre de la collection avant de tenter d’effectuer des opérations sur le TreeNode. Vous pouvez utiliser cette méthode pour confirmer qu’un TreeNode a été ajouté ou est toujours membre de la collection.

Le temps nécessaire à cette méthode est proportionnel à la taille de la collection de nœuds. Vous pouvez donc éviter de l’utiliser avec de grandes collections.

Cette méthode vérifie uniquement l’égalité des références. Vous ne pouvez pas l’utiliser pour déterminer si un nœud équivalent mais différent se trouve dans la collection.

Notes

L’une des implications de l’exigence d’égalité de référence est que vous ne pouvez pas personnaliser le comportement de cette méthode pour les types dérivés TreeNode en remplaçant la Equals méthode de la TreeNode classe.