ToolBar.ToolBarButtonCollection.RemoveAt Method

Removes a given button from the toolbar button collection.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in

public void RemoveAt (
	int index
public final void RemoveAt (
	int index
public final function RemoveAt (
	index : int
Not applicable.



The indexed location of the ToolBarButton in the collection.

Exception typeCondition


The index value is less than 0, or it is greater than the number of buttons in the collection.

The Remove method removes the ToolBarButton at the specified location in the ToolBar.ToolBarButtonCollection. If you want to remove all ToolBarButton controls from the collection, use the Clear method.

The following code example removes the last ToolBarButton on a ToolBar. The index value of the toolbar button being removed is set equal to the Count property, minus one, since the ToolBarButton collection is a zero-based index.

public void RemoveMyButton()
    int btns;
    btns = toolBar1.Buttons.Count;
    // Remove the last toolbar button.
    toolBar1.Buttons.RemoveAt(btns - 1);

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions