TreeNodeCollection.AddRange(TreeNode[]) 메서드

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

이전에 만든 트리 노드의 배열을 컬렉션에 추가합니다.

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

매개 변수

nodes

TreeNode[]

컬렉션에 추가할 트리 노드를 나타내는 TreeNode 개체의 배열입니다.

예외

ArgumentNullException

nodes이(가) null인 경우

ArgumentException

nodes가 다른 TreeView의 자식인 경우

예제

다음 코드 예제에서는 TreeNodeCollectionTreeView 에서 임시 Array로 복사한 다음 메서드를 사용하여 AddRange 배열의 내용을 다른 TreeView 에 추가합니다. TreeNodeCollection 소스 TreeView 의 는 메서드를 사용하여 지워집니다Clear. 이 예제에서는 두 개의 TreeView 컨트롤이 있어야 합니다. 하나는 개체 컬렉션 TreeNode 입니다.

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

설명

TreeNode 배열에 nodes 포함된 개체는 컬렉션의 끝에 추가됩니다.

메서드를 사용하여 컬렉션에 AddRange 각각 TreeNode 을 수동으로 추가하는 대신 이전에 만든 TreeNode 개체 그룹을 컬렉션 Add 에 빠르게 추가할 수 있습니다.

이전에 추가한 를 TreeNode 제거하려면 , RemoveAt또는 Clear 메서드를 Remove사용합니다.

추가 정보

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