WebConfigurationManager Klasse

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.

Bietet Zugriff auf Konfigurationsdateien, während sie für Webanwendungen gelten.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Vererbung: Object
WebConfigurationManager

Beispiele

Das folgende Beispiel zeigt, wie Sie auf Konfigurationsinformationen mit der

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 der WebConfigurationManager Klasse können Sie auf Computer- und Anwendungsinformationen zugreifen.

Die Verwendung 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 behandeln, 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 WebConfigurationManagerihnen bereitgestellten Methoden verwenden. Für <appSettings> und <connectionStrings>, verwenden Sie die AppSettings und ConnectionStrings Eigenschaften. 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, für sich selbst oder für andere Anwendungen oder Computer lokal oder remote lesen und schreiben. Sie verwenden eine der open Methoden, die von WebConfigurationManagerbereitgestellt werden. Diese Methoden geben ein Configuration Objekt zurück, das wiederum die erforderlichen Methoden und Eigenschaften zum Behandeln der zugrunde liegenden Konfigurationsdateien bereitstellt. Diese Methoden führen Lese- oder Schreibvorgänge aus und erstellen die Konfigurationsdaten bei jedem Öffnen einer Datei neu.
- Advanced configuration. Die erweiterte Konfiguration wird von den Typen SectionInformation, , PropertyInformation, PropertyInformationCollection, ElementInformation, , ContextInformation, und ConfigurationSectionGroup ConfigurationSectionGroupCollection.
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 einem attributgesteuerten Modell erweitern. Ein Beispiel zum programmgesteuerten Erweitern eines Standardkonfigurationstyps finden Sie in der ConfigurationSection Klasse. Ein Beispiel zum Erweitern eines Standardkonfigurationstyps mithilfe des attributten Modells finden Sie in der ConfigurationElement Klasse.

Hinweise für Vererber

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

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

Leseberechtigung für die Konfigurationsdatei auf der aktuellen Konfigurationshierarchieebene.
Leseberechtigungen für alle übergeordneten Konfigurationsdateien.

Wenn Ihre Anwendung schreibgeschützten Zugriff auf ihre eigene Konfiguration benötigt, empfiehlt es sich, 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 verwendet, 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 zum Schreiben von Konfigurationsinformationen. Beachten Sie, dass der Benutzer oder der Prozess, der schreibt, über die folgenden Berechtigungen verfügen muss:

Schreibberechtigung für die Konfigurationsdatei und das Verzeichnis auf der aktuellen Hierarchieebene der Konfiguration.
Leseberechtigungen für alle Konfigurationsdateien.

Eigenschaften

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

Methoden

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

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?