TreeNodeCollection.Contains(TreeNode) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Bestimmt, ob der angegebene Strukturknoten ein Element der Auflistung ist.
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
Gibt zurück
true wenn es sich um TreeNode ein Element der Auflistung handelt, andernfalls false.
Beispiele
Im folgenden Codebeispiel wird ermittelt, ob sich ein angegebenes TreeNode Objekt in einer TreeNodeCollectionAuflistung befindet, und anschließend die Auflistung aufgezählt. In diesem Beispiel ist es erforderlich, dass Sie über ein FormTreeView Element verfügen, das TreeNodeCollection einen TreeNode benannten Namen myTreeNode2enthält.
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 ermitteln, ob ein TreeNode Element der Auflistung ist, bevor Sie versuchen, Vorgänge für die TreeNodeAuflistung auszuführen. Sie können diese Methode verwenden, um zu bestätigen, dass ein TreeNode Element der Auflistung hinzugefügt wurde oder noch ein Element ist.
Die Zeit, die diese Methode benötigt, ist proportional zur Größe der Knotenauflistung, sodass Sie die Verwendung mit großen Auflistungen vermeiden möchten.
Diese Methode sucht nur nach Referenzgleichheit. Sie können es nicht verwenden, um zu bestimmen, ob sich ein gleichwertiger, aber anderer Knoten in der Auflistung befindet.
Note
Eine Auswirkung der Anforderung zur Referenzgleichstellung besteht darin, dass Sie das Verhalten dieser Methode nicht für abgeleitete TreeNode Typen anpassen können, indem Sie die Equals Methode der TreeNode Klasse außer Kraft setzen.