ConfigurationElementCollection.BaseClear Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Package:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Source:

ConfigurationElementCollection.cs

Removes all configuration element objects from the collection.

protected public:
 void BaseClear();

protected internal void BaseClear ();

member this.BaseClear : unit -> unit

Protected Friend Sub BaseClear ()

Exceptions

ConfigurationErrorsException

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.

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

Public Sub Remove(ByVal url As UrlConfigElement)
    If BaseIndexOf(url) >= 0 Then
        BaseRemove(url.Name)
        ' Your custom code goes here.
        Console.WriteLine("UrlsCollection: {0}", "Removed collection element!")
    End If
End Sub

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.