Freigeben über


TreeNodeCollection.AddRange(TreeNode[]) Methode

Definition

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 der Auflistung hinzuzufügenden Strukturknoten darstellen.

Ausnahmen

nodes ist null.

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 .

Gilt für:

Weitere Informationen