TreeNodeCollection.Contains(TreeNode) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Determina si el nodo de árbol especificado es un miembro de la colección.

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

Parámetros

node

TreeNode

TreeNode que se va a buscar en la colección.

Devoluciones

Boolean

Es true si el objeto TreeNode es un miembro de la colección; en caso contrario, es false.

Ejemplos

En el ejemplo de código siguiente se determina si un objeto especificado TreeNode está dentro de y TreeNodeCollection, a continuación, enumera la colección. En este ejemplo se requiere que tenga un Form objeto con un TreeView objeto que TreeNodeCollection contenga un TreeNode objeto denominado 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

Comentarios

Este método permite determinar si un TreeNode es miembro de la colección antes de intentar realizar operaciones en .TreeNode Puede usar este método para confirmar que se ha agregado un elemento TreeNode a o que sigue siendo miembro de la colección.

La cantidad de tiempo que tarda este método es proporcional al tamaño de la colección de nodos, por lo que es posible que quiera evitar su uso con colecciones de gran tamaño.

Este método comprueba solo la igualdad de referencia. No se puede usar para determinar si un nodo equivalente pero diferente está en la colección.

Nota

Una implicación del requisito de igualdad de referencia es que no se puede personalizar el comportamiento de este método para los tipos derivados TreeNode reemplazando el Equals método de la TreeNode clase .