Configuration.GetSection(String) Méthode

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

Configuration.cs

Retourne l'objet ConfigurationSection spécifié.

public:
 System::Configuration::ConfigurationSection ^ GetSection(System::String ^ sectionName);

public System.Configuration.ConfigurationSection GetSection (string sectionName);

member this.GetSection : string -> System.Configuration.ConfigurationSection

Public Function GetSection (sectionName As String) As ConfigurationSection

Paramètres

sectionName

String

Chemin d'accès de la section à retourner.

Retours

ConfigurationSection

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

Exemples

L’exemple suivant montre comment utiliser la GetSection méthode pour accéder à une section personnalisée. Pour obtenir l’exemple de code complet qui définit une classe qui stocke des informations pour la CustomSection section , consultez la vue d’ensemble de la Configuration classe.

// Show how to use the GetSection(string) method.
static void GetCustomSection()
{
    try
    {

        CustomSection customSection;

        // Get the current configuration file.
        System.Configuration.Configuration config =
                ConfigurationManager.OpenExeConfiguration(
                ConfigurationUserLevel.None) as Configuration;

        customSection =
            config.GetSection("CustomSection") as CustomSection;

        Console.WriteLine("Section name: {0}", customSection.Name);
        Console.WriteLine("Url: {0}", customSection.Url);
        Console.WriteLine("Port: {0}", customSection.Port);
    }
    catch (ConfigurationErrorsException err)
    {
        Console.WriteLine("Using GetSection(string): {0}", err.ToString());
    }
}

' Show how to use the GetSection(string) method.
Public Shared Sub GetCustomSection()
    Try

        Dim customSection As CustomSection

        ' Get the current configuration file.
        Dim config As System.Configuration.Configuration = TryCast(ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None), Configuration)

        customSection = TryCast(config.GetSection("CustomSection"), CustomSection)

        Console.WriteLine("Section name: {0}", customSection.Name)
        Console.WriteLine("Url: {0}", customSection.Url)
        Console.WriteLine("Port: {0}", customSection.Port)

    Catch err As ConfigurationErrorsException
        Console.WriteLine("Using GetSection(string): {0}", err.ToString())
    End Try

End Sub

Remarques

Les paramètres de configuration sont contenus dans des sections qui regroupent des paramètres similaires pour des raisons pratiques. La GetSection méthode récupère une section de configuration par son nom.