ConfigurationElementCollection.BaseClear Method

Definition

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 all configuration element objects from the collection.

C#
protected internal void BaseClear();
C#
protected void BaseClear();

Exceptions

The configuration is read-only.

-or-

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

Examples

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

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

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.

Applies to

Product Versions
.NET 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 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
.NET Standard 2.0 (package-provided)
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10