TreeNodeCollection.AddRange(TreeNode[]) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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 (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())

Parameter

nodes

TreeNode[]

Ein Array von TreeNode-Objekten, die die der Auflistung hinzuzufügenden Strukturknoten darstellen.

Ausnahmen

ArgumentNullException

nodes ist null.

ArgumentException

nodes ist das untergeordnete Element einer anderen TreeView.

Beispiele

Im folgenden Codebeispiel wird das TreeNodeCollection von einem TreeView in ein temporäres Arraykopiert und dann mithilfe der -Methode einem anderen TreeViewAddRange der Inhalt des Arrays hinzugefügt. Der TreeNodeCollection aus der Quelle TreeView wird mithilfe der Clear -Methode gelöscht. In diesem Beispiel müssen 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 an das Ende der Auflistung angefügt.

Sie können die AddRange -Methode verwenden, um schnell eine Gruppe zuvor erstellter TreeNode Objekte zur Auflistung hinzuzufügen, anstatt jedes TreeNode der Auflistung manuell mit der Add -Methode hinzuzufügen.

Um eine TreeNode zuvor hinzugefügte zu entfernen, verwenden Sie die RemoveMethoden , RemoveAtoder Clear .

Weitere Informationen

• Add(String)
• CopyTo(Array, Int32)