ConfigurationManager.GetSection(String) Methode

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ConfigurationManager.cs

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

Public Shared Function GetSection (sectionName As String) As Object

Parameter

sectionName

String

Der Konfigurationsabschnittspfad und -name. Knotennamen werden durch Schrägstriche getrennt, z.B. „system.net/mailSettings/smtp“.

Gibt zurück

Object

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

Ausnahmen

ConfigurationErrorsException

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:

• OpenExeConfiguration

• OpenMachineConfiguration

• OpenMappedExeConfiguration

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.

Weitere Informationen

• ConfigurationSection