ConfigurationManager.GetSection(String) Metodo

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationManager.cs

Recupera una sezione di configurazione specificata per la configurazione predefinita dell'applicazione corrente.

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

Percorso e nome della sezione di configurazione. I nomi dei nodi sono separati da barre, ad esempio "system.net/mailSettings/smtp".

Restituisce

Object

Oggetto ConfigurationSection specificato oppure null se la sezione non esiste.

Eccezioni

ConfigurationErrorsException

Non è stato possibile caricare un file di configurazione.

Esempio

Nell'esempio seguente viene illustrato come utilizzare il metodo GetSection. L'esempio fa parte di un esempio più grande fornito per la ConfigurationManager classe.

// 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 combinando il file di configurazione dell'applicazione, il file di configurazione utente locale e il file di configurazione roaming.

Il GetSection metodo accede alle informazioni di configurazione di runtime che non possono modificare. Per modificare la configurazione, usare il GetSection metodo nel file di configurazione ottenuto usando uno dei metodi seguenti:

• OpenExeConfiguration

• OpenMachineConfiguration

• OpenMappedExeConfiguration

Note per gli eredi

È necessario eseguire il cast del valore restituito al tipo di configurazione previsto. Per evitare possibili eccezioni di cast, è consigliabile usare un'operazione di cast condizionale, ad esempio l'operatore as in C# o la funzione TryCast in Visual Basic.

Vedi anche

• ConfigurationSection