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 gezeigt, wie Sie mit den Konfigurationsinformationen auf die

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 Möglichkeit, mit Konfigurationsdateien im Zusammenhang mit Webanwendungen zu arbeiten. Verwenden Sie für Clientanwendungen die ConfigurationManager Klasse.

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

Handling configuration. Um Konfigurationsinformationen mithilfe der Standardtypen zu behandeln, verwenden Sie eine der folgenden Ansätze:
- Accessing a section. Um auf Konfigurationsinformationen für Ihre Anwendung zuzugreifen, müssen Sie eine der methoden verwenden, die GetSection von WebConfigurationManager. 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 methoden, die open von WebConfigurationManager. 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 Sie die Konfigurationsdaten jedes Mal neu, wenn eine Datei geöffnet wird.
- Advanced configuration. Die erweiterte Konfiguration wird von den Typen SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, , ConfigurationSectionGroup, und .ConfigurationSectionGroupCollection
Extending configuration standard types. Sie können auch Ihre benutzerdefinierten Konfigurationselemente bereitstellen, indem Sie die Standardkonfigurationstypen wie , ConfigurationElement ConfigurationElementCollection, ConfigurationProperty, und ConfigurationSection mithilfe eines programmgesteuerten oder zugeordneten Modells erweitern. Weitere Informationen zum programmgesteuerten Erweitern eines Standardkonfigurationstyps finden Sie in der ConfigurationSection Klasse. Weitere Informationen zum Erweitern eines Standardkonfigurationstyps mithilfe des attributten Modells finden Sie in der ConfigurationElement Klasse.

Hinweise für Vererber

Die Configuration Klasse ermöglicht programmgesteuerten Zugriff für die Bearbeitung 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 zugreifen, um wie folgt zu lesen oder zu schreiben: 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.
Berechtigungen für alle übergeordneten Konfigurationsdateien lesen.

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 aktuell ausgeführte Anwendung zurückgegeben.

Sie verwenden eine der Save Methoden zum Schreiben von Konfigurationsinformationen. Beachten Sie, dass der Benutzer oder prozess, der schreibt, über die folgenden Berechtigungen verfügen muss: – Schreibberechtigung für die Konfigurationsdatei und das Verzeichnis auf der aktuellen Konfigurationshierarchieebene.

Berechtigungen für alle Konfigurationsdateien lesen.

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