TreeNodeCollection.Contains(TreeNode) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina se o nó de árvore especificado é membro da coleção.

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

O TreeNode a ser localizado na coleção.

Retornos

Boolean

true se o TreeNode é um membro da coleção; caso contrário, false.

Exemplos

O exemplo de código a seguir determina se um especificado TreeNode está dentro de um TreeNodeCollectione, em seguida, enumera a coleção. Este exemplo exige que você tenha um Form com um TreeView que contém um TreeNodeCollection TreeNode nome 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

Comentários

Esse método permite determinar se um TreeNode membro da coleção é um membro antes de tentar executar operações no TreeNode. Você pode usar esse método para confirmar se um TreeNode foi adicionado ou ainda é um membro da coleção.

A quantidade de tempo que esse método leva é proporcional ao tamanho da coleção de nós, portanto, talvez você queira evitar usá-la com grandes coleções.

Esse método verifica apenas a igualdade de referência. Você não pode usá-lo para determinar se um nó equivalente, mas diferente, está na coleção.

Observação

Uma implicação do requisito de igualdade de referência é que você não pode personalizar o comportamento desse método para tipos derivados TreeNode substituindo o Equals método da TreeNode classe.

Aplica-se a

Partilhar via