TreeNodeCollection.AddRange(TreeNode[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Добавляет массив ранее созданных узлов дерева в коллекцию.
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())
Параметры
Исключения
nodes равно null.
nodes является дочерним элементом другого TreeView.
Примеры
В следующем примере кода копируется TreeNodeCollection из TreeView временного файла в временный Array, а затем добавляется содержимое массива в другой TreeView с помощью AddRange метода. От 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 ранее объект, используйте RemoveRemoveAtметоды или Clear методы.