ConfigurationManager.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.
Ruft einen angegebenen Konfigurationsabschnitt für die Standardkonfiguration der aktuellen Anwendung ab.
public:
static System::Object ^ GetSection(System::String ^ sectionName);public static object GetSection (string sectionName);static member GetSection : string -> objPublic Shared Function GetSection (sectionName As String) As ObjectParameter
- sectionName
- String
Der Konfigurationsabschnittspfad und -name. Knotennamen werden durch Schrägstriche getrennt, z.B. „system.net/mailSettings/smtp“.
Gibt zurück
Das angegebene ConfigurationSection-Objekt oder null, wenn der Abschnitt nicht vorhanden ist.
Ausnahmen
Eine Konfigurationsdatei konnte nicht geladen werden.
Beispiele
Im folgenden Beispiel wird die Verwendung der GetSection-Methode gezeigt. Das Beispiel ist Teil eines größeren Beispiels, das für die ConfigurationManager -Klasse bereitgestellt wird.
// Create the AppSettings section.
// The function uses the GetSection(string)method
// to access the configuration section.
// It also adds a new element to the section collection.
public static void CreateAppSettings()
{
// Get the application configuration file.
System.Configuration.Configuration config =
ConfigurationManager.OpenExeConfiguration(
ConfigurationUserLevel.None);
string sectionName = "appSettings";
// Add an entry to appSettings.
int appStgCnt =
ConfigurationManager.AppSettings.Count;
string newKey = "NewKey" + appStgCnt.ToString();
string newValue = DateTime.Now.ToLongDateString() +
" " + DateTime.Now.ToLongTimeString();
config.AppSettings.Settings.Add(newKey, newValue);
// Save the configuration file.
config.Save(ConfigurationSaveMode.Modified);
// Force a reload of the changed section. This
// makes the new values available for reading.
ConfigurationManager.RefreshSection(sectionName);
// Get the AppSettings section.
AppSettingsSection appSettingSection =
(AppSettingsSection)config.GetSection(sectionName);
Console.WriteLine();
Console.WriteLine("Using GetSection(string).");
Console.WriteLine("AppSettings section:");
Console.WriteLine(
appSettingSection.SectionInformation.GetRawXml());
}
' Create the AppSettings section.
' The function uses the GetSection(string)method
' to access the configuration section.
' It also adds a new element to the section collection.
Public Shared Sub CreateAppSettings()
' Get the application configuration file.
Dim config As System.Configuration.Configuration = _
ConfigurationManager.OpenExeConfiguration( _
ConfigurationUserLevel.None)
Dim sectionName As String = "appSettings"
' Add an entry to appSettings.
Dim appStgCnt As Integer = _
ConfigurationManager.AppSettings.Count
Dim newKey As String = _
"NewKey" + appStgCnt.ToString()
Dim newValue As String = _
DateTime.Now.ToLongDateString() + " " + _
DateTime.Now.ToLongTimeString()
config.AppSettings.Settings.Add(newKey, _
newValue)
' Save the configuration file.
config.Save(ConfigurationSaveMode.Modified)
' Force a reload of the changed section. This
' makes the new values available for reading.
ConfigurationManager.RefreshSection(sectionName)
' Get the AppSettings section.
Dim appSettingSection As AppSettingsSection = _
DirectCast(config.GetSection(sectionName), _
AppSettingsSection)
Console.WriteLine()
Console.WriteLine( _
"Using GetSection(string).")
Console.WriteLine( _
"AppSettings section:")
Console.WriteLine( _
appSettingSection.SectionInformation.GetRawXml())
End Sub
Hinweise
Bei Clientanwendungen ruft diese Methode eine Konfigurationsdatei ab, die durch Zusammenführen der Anwendungskonfigurationsdatei, der lokalen Benutzerkonfigurationsdatei und der Roamingkonfigurationsdatei abgerufen wird.
Die GetSection Methode greift auf Laufzeitkonfigurationsinformationen zu, die sie nicht ändern kann. Um die Konfiguration zu ändern, verwenden Sie die GetSection -Methode für die Konfigurationsdatei, die Sie mithilfe einer der folgenden Methoden abrufen:
Hinweise für Vererber
Sie müssen den Rückgabewert in den erwarteten Konfigurationstyp umwandeln. Um mögliche Umwandlungsausnahmen zu vermeiden, sollten Sie einen bedingten Umwandlungsvorgang wie den as Operator in C# oder die TryCast-Funktion in Visual Basic verwenden.
