ConfigurationManager.GetSection(String) Méthode

Définition

Récupère une section de configuration spécifiée pour la configuration par défaut de l'application actuelle.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

Paramètres

sectionName
String

Chemin d'accès et nom de la section de configuration.The configuration section path and name. Les noms de nœud sont séparés par des barres obliques inverses, par exemple "system.net/mailSettings/smtp".Node names are separated by forward slashes, for example "system.net/mailSettings/smtp".

Retours

Object

Objet ConfigurationSection spécifié, ou null si la section n’existe pas.The specified ConfigurationSection object, or null if the section does not exist.

Exceptions

Nous n’avons pas pu charger un fichier de configuration.A configuration file could not be loaded.

Exemples

L'exemple suivant illustre l'utilisation de la méthode GetSection.The following example shows how to use the GetSection method. L’exemple fait partie d’un exemple plus complet fourni pour la 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

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 de l’utilisateur local et le fichier de configuration d’itinérance.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.

La GetSection méthode accède aux informations de configuration au moment de l’exécution qu’elle ne peut pas modifier.The GetSection method accesses run-time configuration information that it cannot change. Pour modifier la configuration, vous utilisez la GetSection méthode sur le fichier de configuration que vous obtenez à l’aide de l’une des méthodes suivantes :To change the configuration, you use the GetSection method on the configuration file that you obtain by using one of the following methods:

Notes pour les héritiers

Vous devez effectuer un cast de la valeur de retour vers le type de configuration attendu.You must cast the return value to the expected configuration type. 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.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.

S’applique à

Voir aussi