Configuration.GetSection(String) Método

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

Parâmetros

Devoluções

O objeto especificado ConfigurationSection , ou null se a secção solicitada não existir.

Exemplos

O exemplo seguinte mostra como usar o GetSection método para aceder a uma secção personalizada. Para o código de exemplo completo que define uma classe que armazena informação para a CustomSection secção, veja a Configuration visão geral da classe.

// 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

Observações

As definições de configuração estão contidas em secções que agrupam definições semelhantes para maior conveniência. O GetSection método recupera uma secção de configuração pelo seu nome.