This topic has not yet been rated - Rate this topic

ConfigurationElementCollection.BaseClear Method

.NET Framework 4.5

Removes all configuration element objects from the collection.

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

protected internal void BaseClear()

Exceptions

Exception	Condition
ConfigurationErrorsException	The configuration is read-only. - or - A collection item has been locked in a higher-level configuration.

Exception

Condition

ConfigurationErrorsException

The configuration is read-only.

- or -

A collection item has been locked in a higher-level configuration.

Remarks

When the BaseClear method is called, it removes all ConfigurationElement objects from the collection. It also inserts a clear directive into the configuration file.

Examples

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

public void Remove(UrlConfigElement url)
{
    if (BaseIndexOf(url) >= 0)
    {
        BaseRemove(url.Name);
        // Your custom code goes here.
        Console.WriteLine("UrlsCollection: {0}", "Removed collection element!");
    }
}

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Reference

ConfigurationElementCollection Class

System.Configuration Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)