Configuration.GetSection(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.