ConfigurationManager.GetSection(String) Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

ConfigurationManager.cs

Récupère une section de configuration spécifiée pour la configuration par défaut de l'application actuelle.

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

Paramètres

sectionName

String

Chemin d'accès et nom de la section de configuration. Les noms de nœud sont séparés par des barres obliques inverses, par exemple "system.net/mailSettings/smtp".

Retours

Object

Objet ConfigurationSection spécifié, ou null si la section n’existe pas.

Exceptions

ConfigurationErrorsException

Nous n’avons pas pu charger un fichier de configuration.

Exemples

L'exemple suivant illustre l'utilisation de la méthode GetSection. L’exemple fait partie d’un exemple plus grand fourni pour 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

Remarques

Pour les applications clientes, cette méthode récupère un fichier de configuration obtenu en fusionnant le fichier de configuration de l’application, le fichier de configuration utilisateur local et le fichier de configuration itinérant.

La GetSection méthode accède aux informations de configuration au moment de l’exécution qu’elle ne peut pas modifier. Pour modifier la configuration, vous utilisez la méthode sur le GetSection fichier de configuration que vous obtenez à l’aide de l’une des méthodes suivantes :

• OpenExeConfiguration

• OpenMachineConfiguration

• OpenMappedExeConfiguration

Notes pour les héritiers

Vous devez caster la valeur de retour dans le type de configuration attendu. Pour éviter les éventuelles exceptions de cast, vous devez utiliser une opération de cast conditionnelle comme l’opérateur as en C# ou la fonction TryCast en Visual Basic.

Voir aussi

• ConfigurationSection