Configuration.GetSection(String) Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

Configuration.cs

Gibt das angegebene ConfigurationSection-Objekt zurück.

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

Parameter

sectionName

String

Der Pfad zu dem Abschnitt, der zurückgegeben werden soll.

Gibt zurück

ConfigurationSection

Das angegebene ConfigurationSection-Objekt oder null, wenn der angeforderte Abschnitt nicht vorhanden ist.

Beispiele

Das folgende Beispiel zeigt, wie Sie mit der GetSection -Methode auf einen benutzerdefinierten Abschnitt zugreifen. Den vollständigen Beispielcode, der eine Klasse definiert, die Informationen für den CustomSection Abschnitt speichert, finden Sie in der Configuration Klassenübersicht.

// 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

Hinweise

Konfigurationseinstellungen sind in Abschnitten enthalten, in denen ähnliche Einstellungen zur Vereinfachung gruppiert werden. Die GetSection -Methode ruft einen Konfigurationsabschnitt anhand seines Namens ab.