ConfigurationSectionCollection.Add(String, ConfigurationSection) Method

Reference

Definition

Namespace:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.Configuration.dll

Package:: System.Configuration.ConfigurationManager v10.0.0-preview.1.25080.5

Source:: ConfigurationSectionCollection.cs

Source:: ConfigurationSectionCollection.cs

Source:: ConfigurationSectionCollection.cs

Source:: ConfigurationSectionCollection.cs

Source:: ConfigurationSectionCollection.cs

Source:: ConfigurationSectionCollection.cs

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.

Adds a ConfigurationSection object to the ConfigurationSectionCollection object.

public:
 void Add(System::String ^ name, System::Configuration::ConfigurationSection ^ section);

public void Add(string name, System.Configuration.ConfigurationSection section);

member this.Add : string * System.Configuration.ConfigurationSection -> unit

Public Sub Add (name As String, section As ConfigurationSection)

Parameters

name: String

The name of the section to be added.

section: ConfigurationSection

The section to be added.

Examples

The following example shows how to use the Add method.

static void AddSection()
{

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

        CustomSection customSection =
            new CustomSection();

        string index =
            config.Sections.Count.ToString();

        customSection.FileName =
            "newFile" + index + ".txt";

        string sectionName = "CustomSection" + index;

        TimeSpan ts = new TimeSpan(0, 15, 0);
        customSection.MaxIdleTime = ts;
        customSection.MaxUsers = 100;

        config.Sections.Add(sectionName, customSection);
        customSection.SectionInformation.ForceSave = true;
        config.Save(ConfigurationSaveMode.Full);
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine(err.ToString());
    }
}

Shared Sub AddSection()

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

        Dim customSection _
        As New CustomSection()


        Dim index As String = _
        config.Sections.Count.ToString()

        customSection.FileName = _
        "newFile" + index + ".txt"

        Dim sectionName As String = _
        "CustomSection" + index

        Dim ts As New TimeSpan(0, 15, 0)
        customSection.MaxIdleTime = ts
        customSection.MaxUsers = 100

        config.Sections.Add(sectionName, customSection)
        customSection.SectionInformation.ForceSave = True
        config.Save(ConfigurationSaveMode.Full)
    Catch err As ConfigurationErrorsException
        Console.WriteLine(err.ToString())
    End Try
End Sub

Remarks

By default, this method adds the specified ConfigurationSection object if it is not already contained within the collection.

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

Share via