WebConfigurationManager Klasse

Definition

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Vererbung

Object

WebConfigurationManager

Beispiele

Im folgenden Beispiel wird der Zugriff auf Konfigurationsinformationen mit dem

GetSection -Methode.

// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // Get the connectionStrings section.
    ConnectionStringsSection connectionStringsSection =
        WebConfigurationManager.GetSection("connectionStrings")
        as ConnectionStringsSection;

    // Get the connectionStrings key,value pairs collection.
    ConnectionStringSettingsCollection connectionStrings =
        connectionStringsSection.ConnectionStrings;
   
    // Get the collection enumerator.
    IEnumerator connectionStringsEnum =
        connectionStrings.GetEnumerator();

    // Loop through the collection and 
    // display the connectionStrings key, value pairs.
    int i = 0;
    Console.WriteLine("[Display the connectionStrings]");
    while (connectionStringsEnum.MoveNext())
    {
        string name = connectionStrings[i].Name;
        Console.WriteLine("Name: {0} Value: {1}",
        name, connectionStrings[name]);
        i += 1;
    }

    Console.WriteLine();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

Hinweise

Mit WebConfigurationManager der -Klasse können Sie auf Computer- und Anwendungsinformationen zugreifen.

Verwenden WebConfigurationManager ist die bevorzugte Methode zum Arbeiten mit Konfigurationsdateien im Zusammenhang mit Webanwendungen. Verwenden Sie für Clientanwendungen die ConfigurationManager -Klasse.

Ihre Anwendung kann die System.Configuration Typen erweitern oder direkt verwenden, um Konfigurationsinformationen zu verarbeiten, wie in der folgenden Liste erläutert:

• Handling configuration. Um Konfigurationsinformationen mithilfe der Standardtypen zu verarbeiten, verwenden Sie einen der folgenden Ansätze:

  • Accessing a section. Um auf Konfigurationsinformationen für Ihre Anwendung zuzugreifen, müssen Sie eine der GetSection von bereitgestellten WebConfigurationManagerMethoden verwenden. Für <appSettings> und <connectionStrings>verwenden Sie die AppSettings Eigenschaften und ConnectionStrings . Diese Methoden führen schreibgeschützte Vorgänge aus, verwenden eine einzelne zwischengespeicherte Instanz der Konfiguration und sind Multithread-fähig.

  • Accessing configuration files. Ihre Anwendung kann Konfigurationseinstellungen auf jeder Ebene lesen und schreiben, für sich selbst oder für andere Anwendungen oder Computer, lokal oder remote. Sie verwenden eine der open von bereitgestellten WebConfigurationManagerMethoden. Diese Methoden geben ein Configuration -Objekt zurück, das wiederum die erforderlichen Methoden und Eigenschaften bereitstellt, um die zugrunde liegenden Konfigurationsdateien zu behandeln. Diese Methoden führen Lese- oder Schreibvorgänge aus und erstellen die Konfigurationsdaten jedes Mal neu, wenn eine Datei geöffnet wird.

  • Advanced configuration. Erweiterte Konfigurationsbehandlung wird durch die Typen SectionInformation, , PropertyInformation, PropertyInformationCollectionElementInformation, ContextInformation, ConfigurationSectionGroupund ConfigurationSectionGroupCollectionbereitgestellt.

• Extending configuration standard types. Sie können Ihre benutzerdefinierten Konfigurationselemente auch bereitstellen, indem Sie die Standardkonfigurationstypen wie ConfigurationElement, ConfigurationElementCollection, ConfigurationPropertyund ConfigurationSection mithilfe eines programmgesteuerten oder attributierten Modells erweitern. Ein Beispiel zum programmgesteuerten Erweitern eines Standardkonfigurationstyps finden Sie in der ConfigurationSection -Klasse. ConfigurationElement Ein Beispiel zum Erweitern eines Standardkonfigurationstyps mithilfe des attributierten Modells finden Sie in der -Klasse.

Hinweise für Vererber

Die Configuration -Klasse ermöglicht programmgesteuerten Zugriff zum Bearbeiten von Konfigurationsdateien. Sie verwenden eine der offenen Methoden, die von bereitgestellt werden WebConfigurationManager. Diese Methoden geben ein Configuration -Objekt zurück, das wiederum die erforderlichen Methoden und Eigenschaften bereitstellt, um die zugrunde liegenden Konfigurationsdateien zu behandeln. Sie können wie folgt auf diese Dateien zum Lesen oder Schreiben zugreifen:

Sie verwenden GetSection(String) oder GetSectionGroup(String) zum Lesen von Konfigurationsinformationen. Beachten Sie, dass der Benutzer oder Prozess, der gelesen wird, über die folgenden Berechtigungen verfügen muss:

• Lesen Sie die Berechtigung für die Konfigurationsdatei auf der aktuellen Konfigurationshierarchieebene.

• Lesen Sie Berechtigungen für alle übergeordneten Konfigurationsdateien.

Wenn Ihre Anwendung schreibgeschützten Zugriff auf ihre eigene Konfiguration benötigt, wird empfohlen, die GetSection Methoden zu verwenden. Diese Methoden bieten Zugriff auf die zwischengespeicherten Konfigurationswerte für die aktuelle Anwendung, die eine bessere Leistung als die Configuration Klasse aufweist.

Hinweis: Wenn Sie eine statische GetSection Methode verwenden, die einen path Parameter akzeptiert, muss der Pfadparameter auf die Anwendung verweisen, in der der Code ausgeführt wird. Andernfalls wird der Parameter ignoriert und Konfigurationsinformationen für die derzeit ausgeführte Anwendung zurückgegeben.

Sie verwenden eine der Save Methoden, um Konfigurationsinformationen zu schreiben. Beachten Sie, dass der Benutzer oder der Prozess, der schreibt, über die folgenden Berechtigungen verfügen muss:

• Schreiben Sie die Berechtigung für die Konfigurationsdatei und das Verzeichnis auf der aktuellen Konfigurationshierarchieebene.

• Lesen Sie Berechtigungen für alle Konfigurationsdateien.

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Configuration
• ConfigurationManager
• Übersicht über ASP.NET-Konfiguration