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 zu dem Abschnitt, der zurückgegeben werden soll.
Gibt zurück
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.