ConfigurationElementCollection.BaseRemoveAt Method (System.Configuration)

BaseRemoveAt Method

.NET Framework Class Library

ConfigurationElementCollection..::.BaseRemoveAt Method

Removes the ConfigurationElement at the specified index location.

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

Syntax

Visual Basic (Declaration)

Protected Friend Sub BaseRemoveAt ( _
    index As Integer _
)

Visual Basic (Usage)

Dim index As Integer

Me.BaseRemoveAt(index)

protected internal void BaseRemoveAt(
    int index
)

Visual C++

protected public:
void BaseRemoveAt(
    int index
)

JScript

protected internal function BaseRemoveAt(
    index : int
)

Parameters

index: Type: System..::.Int32
The index location of the ConfigurationElement to remove.

Exceptions

Exception	Condition
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.

Exception

Condition

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.

Remarks

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

Examples

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

public void RemoveAt(int index)
{
    BaseRemoveAt(index);
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, 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.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

ConfigurationElementCollection Class

ConfigurationElementCollection Members

System.Configuration Namespace