Edit

ConfigurationSectionCollection.Add(String, ConfigurationSection) Method

  • Reference

Definition

Namespace:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.Configuration.dll
Package:
System.Configuration.ConfigurationManager v6.0.0
Package:
System.Configuration.ConfigurationManager v7.0.0
Package:
System.Configuration.ConfigurationManager v8.0.0
Package:
System.Configuration.ConfigurationManager v9.0.0-preview.3.24172.9
Source:
ConfigurationSectionCollection.cs
Source:
ConfigurationSectionCollection.cs
Source:
ConfigurationSectionCollection.cs
Source:
ConfigurationSectionCollection.cs

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

See also