ConfigurationManager.GetSection(String) Método

Definição

Recupera uma seção de configuração especificada para a configuração padrão do aplicativo atual.Retrieves a specified configuration section for the current application's default configuration.

public:
 static System::Object ^ GetSection(System::String ^ sectionName);
public static object GetSection (string sectionName);
static member GetSection : string -> obj
Public Shared Function GetSection (sectionName As String) As Object

Parâmetros

sectionName
String

O nome e o caminho da seção de configuração.The configuration section path and name. Nomes de nó são separados por barras, por exemplo "system.net/mailSettings/smtp".Node names are separated by forward slashes, for example "system.net/mailSettings/smtp".

Retornos

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

Exceções

Não foi possível carregar um arquivo de configuração.A configuration file could not be loaded.

Exemplos

O exemplo a seguir mostra como usar o método GetSection.The following example shows how to use the GetSection method. O exemplo é parte de um exemplo maior que é fornecido para a classe ConfigurationManager.The example is part of a larger example that is provided for the ConfigurationManager class.

// Create the AppSettings section.
// The function uses the GetSection(string)method 
// to access the configuration section. 
// It also adds a new element to the section collection.
public static void CreateAppSettings()
{
  // Get the application configuration file.
  System.Configuration.Configuration config =
    ConfigurationManager.OpenExeConfiguration(
          ConfigurationUserLevel.None);

  string sectionName = "appSettings";

  // Add an entry to appSettings.
  int appStgCnt =
      ConfigurationManager.AppSettings.Count;
  string newKey = "NewKey" + appStgCnt.ToString();

  string newValue = DateTime.Now.ToLongDateString() + 
    " " + DateTime.Now.ToLongTimeString();

  config.AppSettings.Settings.Add(newKey, newValue);

  // Save the configuration file.
  config.Save(ConfigurationSaveMode.Modified);
  
  // Force a reload of the changed section. This 
  // makes the new values available for reading.
  ConfigurationManager.RefreshSection(sectionName);

  // Get the AppSettings section.
  AppSettingsSection appSettingSection =
    (AppSettingsSection)config.GetSection(sectionName);

  Console.WriteLine();
  Console.WriteLine("Using GetSection(string).");
  Console.WriteLine("AppSettings section:");
  Console.WriteLine(
    appSettingSection.SectionInformation.GetRawXml());
}
' Create the AppSettings section.
' The function uses the GetSection(string)method 
' to access the configuration section. 
' It also adds a new element to the section collection.
Public Shared Sub CreateAppSettings()
    ' Get the application configuration file.
    Dim config As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)

    Dim sectionName As String = "appSettings"

    ' Add an entry to appSettings.
    Dim appStgCnt As Integer = _
        ConfigurationManager.AppSettings.Count
    Dim newKey As String = _
        "NewKey" + appStgCnt.ToString()

    Dim newValue As String = _
        DateTime.Now.ToLongDateString() + " " + _
        DateTime.Now.ToLongTimeString()

    config.AppSettings.Settings.Add(newKey, _
                                    newValue)

    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)

    ' Force a reload of the changed section. This 
    ' makes the new values available for reading.
    ConfigurationManager.RefreshSection(sectionName)

    ' Get the AppSettings section.
    Dim appSettingSection As AppSettingsSection = _
        DirectCast(config.GetSection(sectionName),  _
        AppSettingsSection)

    Console.WriteLine()
    Console.WriteLine( _
        "Using GetSection(string).")
    Console.WriteLine( _
        "AppSettings section:")
    Console.WriteLine( _
        appSettingSection.SectionInformation.GetRawXml())
End Sub

Comentários

Para aplicativos cliente, esse método recupera um arquivo de configuração obtido mesclando o arquivo de configuração do aplicativo, o arquivo de configuração do usuário local e o arquivo de configuração de roaming.For client applications, this method retrieves a configuration file obtained by merging the application configuration file, the local user configuration file, and the roaming configuration file.

O método GetSection acessa informações de configuração em tempo de execução que não podem ser alteradas.The GetSection method accesses run-time configuration information that it cannot change. Para alterar a configuração, use o método GetSection no arquivo de configuração que você obtém usando um dos seguintes métodos abertos:To change the configuration, you use the GetSection method on the configuration file that you obtain by using one of the following Open methods:

Notas aos Herdeiros

Você deve converter o valor de retorno para o tipo de configuração esperado.You must cast the return value to the expected configuration type. Para evitar possíveis exceções de conversão, você deve usar uma operação de conversão condicional, como o operador C# de as no ou a função TryCast no Visual Basic.To avoid possible casting exceptions, you should use a conditional casting operation such as the as operator in C# or the TryCast function in Visual Basic.

Aplica-se a

Veja também