TreeNodeCollection.RemoveAt(Int32) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: TreeNodeCollection.cs

Source:: TreeNodeCollection.cs

Source:: TreeNodeCollection.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Removes a tree node from the tree node collection at a specified index.

public:
 virtual void RemoveAt(int index);

public virtual void RemoveAt(int index);

abstract member RemoveAt : int -> unit
override this.RemoveAt : int -> unit

Public Overridable Sub RemoveAt (index As Integer)

Parameters

index: Int32

The index of the TreeNode to remove.

Implements

RemoveAt(Int32)

Examples

The following code example removes the first TreeNode from a TreeView if its TreeNode.Text property is set to "Node0". When a Button is clicked, the first TreeNode in the TreeView is deleted using the RemoveAt method. This example requires that you have created a TreeView and a Button on a Form. The first TreeNode in your TreeView should have a text property of "Node0."

void button2_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   // Delete the first TreeNode in the collection
   // if the Text property is S"Node0."
   if ( this->treeView1->Nodes[ 0 ]->Text->Equals( "Node0" ) )
   {
      this->treeView1->Nodes->RemoveAt( 0 );
   }
}

private void button2_Click(object sender, EventArgs e)
{
   // Delete the first TreeNode in the collection 
   // if the Text property is "Node0." 
   if(this.treeView1.Nodes[0].Text == "Node0")
   {
      this.treeView1.Nodes.RemoveAt(0);
   }
}

Private Sub button2_Click(sender As Object, e As EventArgs) Handles button2.Click
   ' Delete the first TreeNode in the collection 
   ' if the Text property is "Node0." 
   If Me.treeView1.Nodes(0).Text = "Node0" Then
      Me.treeView1.Nodes.RemoveAt(0)
   End If
End Sub

Remarks

When a TreeNode is removed from the tree node collection, all subsequent tree nodes are moved up one position in the collection.

You can also remove a TreeNode that you previously added by using the Remove or Clear methods.

Note

Enumerating the collection and removing nodes is not supported.

To add new TreeNode objects to the collection, use the Add, AddRange, or Insert methods.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Share via