TreeNodeCollection.AddRange(TreeNode[]) Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
TreeNodeCollection.cs
Quelle:
TreeNodeCollection.cs
Quelle:
TreeNodeCollection.cs
Quelle:
TreeNodeCollection.cs
Quelle:
TreeNodeCollection.cs

Fügt der Auflistung ein Array von zuvor erstellten Strukturknoten hinzu.

public:
 virtual void AddRange(cli::array <System::Windows::Forms::TreeNode ^> ^ nodes);
public:
 virtual void AddRange(... cli::array <System::Windows::Forms::TreeNode ^> ^ nodes);
public virtual void AddRange(System.Windows.Forms.TreeNode[] nodes);
public virtual void AddRange(params System.Windows.Forms.TreeNode[] nodes);
abstract member AddRange : System.Windows.Forms.TreeNode[] -> unit
override this.AddRange : System.Windows.Forms.TreeNode[] -> unit
Public Overridable Sub AddRange (nodes As TreeNode())
Public Overridable Sub AddRange (ParamArray nodes As TreeNode())

Parameter

nodes
TreeNode[]

Ein Array von TreeNode Objekten, die die Strukturknoten darstellen, die der Auflistung hinzugefügt werden sollen.

Ausnahmen

ArgumentNullException

nodes ist null.

ArgumentException

nodes ist das Kind eines anderen TreeView.

Beispiele

Im folgenden Codebeispiel wird die TreeNodeCollection Von a TreeView in eine temporäre ArrayKopie kopiert und anschließend der Inhalt des Arrays mithilfe der TreeView Methode zu einer anderen AddRange hinzugefügt. Die TreeNodeCollection Quelle wird mithilfe der TreeViewClear Methode gelöscht. Dieses Beispiel erfordert, dass Sie über zwei TreeView Steuerelemente verfügen, eines mit einer Auflistung von TreeNode Objekten.

private:
   void MyButtonAddAllClick( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      
      // Get the 'myTreeNodeCollection' from the 'myTreeViewBase' TreeView.
      TreeNodeCollection^ myTreeNodeCollection = myTreeViewBase->Nodes;
      
      // Create an array of 'TreeNodes'.
      array<TreeNode^>^myTreeNodeArray = gcnew array<TreeNode^>(myTreeViewBase->Nodes->Count);
      
      // Copy the tree nodes to the 'myTreeNodeArray' array.
      myTreeViewBase->Nodes->CopyTo( myTreeNodeArray, 0 );
      
      // Remove all the tree nodes from the 'myTreeViewBase' TreeView.
      myTreeViewBase->Nodes->Clear();
      
      // Add the 'myTreeNodeArray' to the 'myTreeViewCustom' TreeView.
      myTreeViewCustom->Nodes->AddRange( myTreeNodeArray );
   }

private void MyButtonAddAllClick(object sender, EventArgs e)
{
   // Get the 'myTreeNodeCollection' from the 'myTreeViewBase' TreeView.
   TreeNodeCollection myTreeNodeCollection = myTreeViewBase.Nodes;
   // Create an array of 'TreeNodes'.
   TreeNode[] myTreeNodeArray = new TreeNode[myTreeViewBase.Nodes.Count];
   // Copy the tree nodes to the 'myTreeNodeArray' array.
   myTreeViewBase.Nodes.CopyTo(myTreeNodeArray,0);
   // Remove all the tree nodes from the 'myTreeViewBase' TreeView.
   myTreeViewBase.Nodes.Clear();
   // Add the 'myTreeNodeArray' to the 'myTreeViewCustom' TreeView.
   myTreeViewCustom.Nodes.AddRange(myTreeNodeArray);
}

Private Sub MyButtonAddAllClick(sender As Object, e As EventArgs)
   ' Get the 'myTreeNodeCollection' from the 'myTreeViewBase' TreeView.
   Dim myTreeNodeCollection As TreeNodeCollection = myTreeViewBase.Nodes
   ' Create an array of 'TreeNodes'.
   Dim myTreeNodeArray(myTreeViewBase.Nodes.Count-1) As TreeNode
   ' Copy the tree nodes to the 'myTreeNodeArray' array.
   myTreeViewBase.Nodes.CopyTo(myTreeNodeArray, 0)
   ' Remove all the tree nodes from the 'myTreeViewBase' TreeView.
   myTreeViewBase.Nodes.Clear()
   ' Add the 'myTreeNodeArray' to the 'myTreeViewCustom' TreeView.
      myTreeViewCustom.Nodes.AddRange(myTreeNodeArray)
End Sub

Hinweise

Die TreeNode im nodes Array enthaltenen Objekte werden am Ende der Auflistung angefügt.

Mit der AddRange Methode können Sie der Auflistung schnell eine Gruppe zuvor erstellter TreeNode Objekte hinzufügen, anstatt jede TreeNode der Auflistung mithilfe der Add Methode manuell hinzuzufügen.

Um ein zuvor hinzugefügtes Element TreeNode zu entfernen, verwenden Sie die RemoveMethoden oder RemoveAtClear Methoden.

Gilt für:

Weitere Informationen