Configuration.GetSection(String) Метод

Определение

Пространство имен:

System.Configuration

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

Configuration.cs

Возвращает указанный объект ConfigurationSection.

public:
 System::Configuration::ConfigurationSection ^ GetSection(System::String ^ sectionName);

public System.Configuration.ConfigurationSection GetSection (string sectionName);

member this.GetSection : string -> System.Configuration.ConfigurationSection

Public Function GetSection (sectionName As String) As ConfigurationSection

Параметры

sectionName

String

Путь к возвращаемому разделу.

Возвращаемое значение

ConfigurationSection

Указанный объект ConfigurationSection или значение null, если запрошенный раздел не существует.

Примеры

В следующем примере показано, как использовать GetSection метод для доступа к пользовательскому разделу. Полный пример кода, определяющий класс, в котором хранятся сведения для CustomSection раздела, см. в обзоре Configuration класса.

// Show how to use the GetSection(string) method.
static void GetCustomSection()
{
    try
    {

        CustomSection customSection;

        // Get the current configuration file.
        System.Configuration.Configuration config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None) as Configuration;

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

        Console.WriteLine("Section name: {0}", customSection.Name);
        Console.WriteLine("Url: {0}", customSection.Url);
        Console.WriteLine("Port: {0}", customSection.Port);
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine("Using GetSection(string): {0}", err.ToString());
    }
}

' Show how to use the GetSection(string) method.
Public Shared Sub GetCustomSection()
    Try

        Dim customSection As CustomSection

        ' Get the current configuration file.
        Dim config As System.Configuration.Configuration = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        customSection = TryCast(config.GetSection("CustomSection"), CustomSection)

        Console.WriteLine("Section name: {0}", customSection.Name)
        Console.WriteLine("Url: {0}", customSection.Url)
        Console.WriteLine("Port: {0}", customSection.Port)

    Catch err As ConfigurationErrorsException
        Console.WriteLine("Using GetSection(string): {0}", err.ToString())
    End Try

End Sub

Комментарии

Параметры конфигурации содержатся в разделах, которые группируют аналогичные параметры для удобства. Метод GetSection извлекает раздел конфигурации по его имени.