Welcome Sign in
Skip Navigation Links
Microsoft Developer Network
.NET Framework Class Library
ConfigurationElementCollection..::.BaseRemoveAt Method

Updated: November 2007

Removes the ConfigurationElement at the specified index location.

Namespace:  System.Configuration
Assembly:  System.Configuration (in System.Configuration.dll)

Visual Basic (Declaration)
Protected Friend Sub BaseRemoveAt ( _
    index As Integer _
)
Visual Basic (Usage)
Dim index As Integer

Me.BaseRemoveAt(index)
C#
protected internal void BaseRemoveAt(
    int index
)
Visual C++
protected public:
void BaseRemoveAt(
    int index
)
J#
protected void BaseRemoveAt(
    int index
)
JScript
protected internal function BaseRemoveAt(
    index : int
)

Parameters

index
Type: System..::.Int32

The index location of the ConfigurationElement to remove.

ExceptionCondition
ConfigurationErrorsException

The configuration is read-only.

- or -

index is less than 0 or greater than the number of ConfigurationElement objects in the collection.

- or -

The ConfigurationElement object has already been removed.

- or -

The value of the ConfigurationElement object has been locked at a higher level.

- or -

The ConfigurationElement object was inherited.

- or -

The value of the ConfigurationElement object's Type is not AddRemoveClearMap or AddRemoveClearMapAlternate.

The BaseRemoveAt method inserts a <remove> directive into the configuration file for the element at the specified index location.

The following code example shows how to call the BaseRemoveAt method.

Visual Basic
Public Sub RemoveAt(ByVal index As Integer) 
    BaseRemoveAt(index)

End Sub 'RemoveAt
C#
public void RemoveAt(int index)
{
    BaseRemoveAt(index);
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Page view tracker