TreeNodeCollection.Contains(TreeNode) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
Retours
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.