ConfigurationSectionCollection.Remove(String) Method

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Source:

ConfigurationSectionCollection.cs

Removes the specified ConfigurationSection object from this ConfigurationSectionCollection object.

public:
 void Remove(System::String ^ name);

public void Remove (string name);

member this.Remove : string -> unit

Public Sub Remove (name As String)

Parameters

name

String

The name of the section to be removed.

Examples

The following example shows how to use the Remove method.

static void Remove()
{

    try
    {
        System.Configuration.Configuration config =
        ConfigurationManager.OpenExeConfiguration(
        ConfigurationUserLevel.None);

        CustomSection customSection =
            config.GetSection(
            "CustomSection") as CustomSection;

        if (customSection != null)
        {
            config.Sections.Remove("CustomSection");
            customSection.SectionInformation.ForceSave = true;
            config.Save(ConfigurationSaveMode.Full);
        }
        else
            Console.WriteLine(
                "CustomSection does not exists.");
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine(err.ToString());
    }
}

Shared Sub Remove()

    Try
        Dim config _
        As System.Configuration.Configuration = _
        ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)

        Dim customSection As CustomSection = _
        config.GetSection("CustomSection")


        If Not (customSection Is Nothing) Then
            config.Sections.Remove("CustomSection")
            customSection.SectionInformation.ForceSave = True
            config.Save(ConfigurationSaveMode.Full)
        Else
            Console.WriteLine( _
            "CustomSection does not exists.")
        End If

    Catch err As ConfigurationErrorsException
        Console.WriteLine(err.ToString())
    End Try
End Sub

See also

• Configuration
• ConfigurationSectionGroup
• ConfigurationSection