TreeNodeCollection.AddRange(TreeNode[]) TreeNodeCollection.AddRange(TreeNode[]) TreeNodeCollection.AddRange(TreeNode[]) TreeNodeCollection.AddRange(TreeNode[]) Method

Definition

Fügt der Auflistung ein Array von zuvor erstellten Strukturknoten hinzu.Adds an array of previously created tree nodes to the collection.

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.An array of TreeNode objects representing the tree nodes to add to the collection.

Ausnahmen

nodes ist das untergeordnete Element einer anderen TreeView.nodes is the child of another TreeView.

Beispiele

Im folgenden Codebeispiel wird der TreeNodeCollection aus einem TreeView in einen temporären Arraykopiert und der Inhalt des Arrays dann mithilfe der AddRange -Methode TreeView zu einer anderen hinzugefügt.The following code example copies the TreeNodeCollection from a TreeView to a temporary Array, and then adds the contents of the array to another TreeView using the AddRange method. Der TreeNodeCollection aus der Quelle TreeView wird mithilfe der Clear -Methode gelöscht.The TreeNodeCollection from the source TreeView is cleared using the Clear method. Für dieses Beispiel ist es erforderlich, TreeView dass Sie über zwei Steuerelemente verfügen TreeNode , eine mit einer Auflistung von-Objekten.This example requires that you have two TreeView controls, one with a collection of TreeNode objects.

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

TreeNode Dienodes im Array enthaltenen Objekte werden an das Ende der Auflistung angefügt.The TreeNode objects contained in the nodes array are appended to the end of the collection.

Sie können AddRange die-Methode verwenden, um schnell eine Gruppe von zuvor TreeNode erstellten Objekten der Auflistung hinzuzufügen, TreeNode anstatt Sie mithilfe der Add -Methode manuell der Auflistung hinzuzufügen.You can use the AddRange method to quickly add a group of previously created TreeNode objects to the collection instead of manually adding each TreeNode to the collection using the Add method.

Verwenden Sie zum TreeNode Entfernen eines, das Sie zuvor hinzu Removegefügt haben, Clear die Methoden, RemoveAtoder.To remove a TreeNode that you previously added, use the Remove, RemoveAt, or Clear methods.

Gilt für:

Siehe auch