ConfigurationManager.GetSection(String) ConfigurationManager.GetSection(String) ConfigurationManager.GetSection(String) ConfigurationManager.GetSection(String) Method

Definizione

Recupera una sezione di configurazione specificata per la configurazione predefinita dell'applicazione corrente.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

Parametri

sectionName
String String String String

Percorso e nome della sezione di configurazione.The configuration section path and name. I nomi dei nodi sono separati da barre, ad esempio "system.net/mailSettings/smtp".Node names are separated by forward slashes, for example "system.net/mailSettings/smtp".

Restituisce

Oggetto ConfigurationSection specificato oppure null se la sezione non esiste.The specified ConfigurationSection object, or null if the section does not exist.

Eccezioni

Non è stato possibile caricare un file di configurazione.A configuration file could not be loaded.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il metodo GetSection.The following example shows how to use the GetSection method. L'esempio fa parte di un esempio più esaustivo fornito per il ConfigurationManager classe.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

Commenti

Per le applicazioni client, questo metodo recupera un file di configurazione ottenuto dall'unione di file di configurazione dell'applicazione, il file di configurazione utente locale e il file di configurazione comune.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.

Il GetSection accede a informazioni di configurazione di run-time che non può modificare.The GetSection method accesses run-time configuration information that it cannot change. Per modificare la configurazione, si utilizza il GetSection metodo nel file di configurazione che è possibile ottenere usando uno dei seguenti metodi di apertura:To change the configuration, you use the GetSection method on the configuration file that you obtain by using one of the following Open methods:

Note per gli eredi

È necessario eseguire il cast del valore restituito al tipo di configurazione previsto.You must cast the return value to the expected configuration type. Per evitare possibili eccezioni di cast, è necessario utilizzare un'operazione cast condizionale, ad esempio il as operatore in c# o la funzione in Visual Basic.To avoid possible casting exceptions, you should use a conditional casting operation such as the as operator in C# or the function in Visual Basic.

Si applica a

Vedi anche