WebConfigurationManager Klasse

Referenz

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

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.

Ermöglicht den Zugriff auf Konfigurationsdateien, wenn diese für Webanwendungen gelten.

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, PropertyInformationCollection ElementInformation, 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

AppSettings	Ruft die Anwendungseinstellungen der Website ab.
ConnectionStrings	Ruft die Verbindungszeichenfolgen der Website ab.

Methoden

GetSection(String)	Ruft den angegebenen Konfigurationsabschnitt aus der Konfigurationsdatei der aktuellen Webanwendung ab.
GetSection(String, String)	Ruft den angegebenen Konfigurationsabschnitt aus der Konfigurationsdatei der Webanwendung am angegebenen Speicherort ab.
GetWebApplicationSection(String)	Ruft den angegebenen Konfigurationsabschnitt aus der Konfigurationsdatei der aktuellen Webanwendung ab.
OpenMachineConfiguration()	Öffnet die Computerkonfigurationsdatei auf dem aktuell verwendeten Computer als Configuration-Objekt, um Lese- oder Schreibvorgänge zu ermöglichen.
OpenMachineConfiguration(String)	Öffnet die Computerkonfigurationsdatei auf dem aktuell verwendeten Computer als Configuration-Objekt, um Lese- oder Schreibvorgänge zu ermöglichen.
OpenMachineConfiguration(String, String)	Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration-Objekt, um Lese- oder Schreibvorgänge zu ermöglichen.
OpenMachineConfiguration(String, String, IntPtr)	Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration-Objekt, um mithilfe des angegebenen Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen.
OpenMachineConfiguration(String, String, String, String)	Öffnet die angegebene Computerkonfigurationsdatei auf dem angegebenen Server als Configuration-Objekt, um mithilfe des angegebenen Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Öffnet die Computerkonfigurationsdatei als Configuration-Objekt, um mithilfe der angegebenen Dateizuordnung Lese- oder Schreibvorgänge zu ermöglichen.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Öffnet die Computerkonfigurationsdatei als Configuration-Objekt, um mithilfe der angegebenen Dateizuordnung und des angegebenen Dateispeicherorts Lese- oder Schreibvorgänge zu ermöglichen.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Öffnet die angegebene Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe der angegebenen Dateizuordnung und des angegebenen virtuellen Pfads Lese- oder Schreibvorgänge zu ermöglichen.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Öffnet die angegebene Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe der angegebenen Dateizuordnung, des angegebenen virtuellen Pfads und des angegebenen Websitenamens Lese- oder Schreibvorgänge zu ermöglichen.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Öffnet die angegebene Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe der angegebenen Dateizuordnung und des angegebenen virtuellen Pfads, des Websitenamens und des Speicherorts Lese- oder Schreibvorgänge zu ermöglichen.
OpenWebConfiguration(String)	Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads Lese- oder Schreibvorgänge zu ermöglichen.
OpenWebConfiguration(String, String)	Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads und des Websitenamens Lese- oder Schreibvorgänge zu ermöglichen.
OpenWebConfiguration(String, String, String)	Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens und des Speicherorts Lese- oder Schreibvorgänge zu ermöglichen.
OpenWebConfiguration(String, String, String, String)	Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts und des Servers Lese- oder Schreibvorgänge zu ermöglichen.
OpenWebConfiguration(String, String, String, String, IntPtr)	Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts, des Servers und des Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen.
OpenWebConfiguration(String, String, String, String, String, String)	Öffnet die Webanwendungskonfigurationsdatei als Configuration-Objekt, um mithilfe des angegebenen virtuellen Pfads, des Websitenamens, des Speicherorts, des Servers und des Sicherheitskontexts Lese- oder Schreibvorgänge zu ermöglichen.

Gilt für:

Freigeben über