Configuration.GetSection(String) Método

Definição

Retorna o objeto ConfigurationSection especificado.Returns the specified ConfigurationSection object.

public:
 System::Configuration::ConfigurationSection ^ GetSection(System::String ^ path);
public System.Configuration.ConfigurationSection GetSection (string path);
member this.GetSection : string -> System.Configuration.ConfigurationSection
Public Function GetSection (path As String) As ConfigurationSection

Parâmetros

sectionName
String

O caminho para a seção a ser retornada.The path to the section to be returned.

Retornos

O objeto ConfigurationSection especificado ou null se a seção solicitada não existir.The specified ConfigurationSection object, or null if the requested section does not exist.

Exemplos

O exemplo a seguir mostra como usar o método GetSection para acessar uma seção personalizada.The following example shows how to use the GetSection method to access a custom section. Para obter o código de exemplo completo que define uma classe que armazena informações para a seção CustomSection, consulte a visão geral da classe Configuration.For the complete example code that defines a class that stores information for the CustomSection section, see the Configuration class overview.

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

Comentários

As definições de configuração estão contidas em seções que agrupam configurações semelhantes para sua conveniência.Configuration settings are contained within sections that group similar settings together for convenience. O método GetSection recupera uma seção de configuração por seu nome.The GetSection method retrieves a configuration section by its name.

Aplica-se a