TreeNodeCollection.AddRange メソッド

.NET Framework クラス ライブラリ リファレンス

TreeNodeCollection.AddRange メソッド

以前に作成したツリー ノードの配列をコレクションに追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub AddRange
 ( _
    nodes As TreeNode() _
)

Visual Basic (使用法)

Dim instance As TreeNodeCollection
Dim nodes As TreeNode()

instance.AddRange(nodes)

C#

public virtual void AddRange (
    TreeNode[] nodes
)

C++

public:
virtual void AddRange (
    array<TreeNode^>^ nodes
)

J#

public void AddRange (
    TreeNode[] nodes
)

JScript

public function AddRange (
    nodes : TreeNode[]
)

パラメータ

nodes

コレクションに追加するツリー ノードを表す TreeNode オブジェクトの配列。

例外

例外の種類	条件
ArgumentNullException	nodes が null 参照 (Visual Basic では Nothing) です。
ArgumentException	nodes が、別の TreeView の子になっています。

解説

nodes 配列に格納されている TreeNode オブジェクトが、コレクションの末尾に追加されます。

AddRange メソッドを使用すると、Add メソッドを使用して TreeNode を 1 つずつ手動でコレクションに追加するのではなく、以前に作成した TreeNode オブジェクトのグループをすばやくコレクションに追加できます。

以前追加した TreeNode を削除するには、Remove、RemoveAt、Clear の各メソッドを使用します。

使用例

TreeNodeCollection を TreeView から一時的な Array にコピーし、この配列の内容を AddRange メソッドを使用して別の TreeView に追加するコード例を次に示します。元の TreeView の TreeNodeCollection は、Clear メソッドによって削除されます。この例は、TreeView コントロールが 2 つあり、一方には TreeNode オブジェクトのコレクションが設定されていることを前提にしています。

Visual Basic

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

C#

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);
}

C++

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 );
   }

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
TreeNodeCollection クラス
TreeNodeCollection メンバ
System.Windows.Forms 名前空間
Add
CopyTo