Configuration.GetSection(String) Methode

Definition

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 zum zurückzugebenden Abschnitt.

Gibt zurück

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

Beispiele

Das folgende Beispiel zeigt, wie Sie mithilfe 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, die ähnliche Einstellungen zur Vereinfachung gruppieren. Die GetSection Methode ruft einen Konfigurationsabschnitt anhand seines Namens ab.

Gilt für: