WebConfigurationManager-Klasse

Der WebConfigurationManager ermöglicht Ihnen den Zugriff auf Computer- und Anwendungsinformationen.

Bei der Arbeit mit Konfigurationsdateien für Webanwendungen empfiehlt sich die Verwendung von WebConfigurationManager. Bei Clienanwendungen sollten Sie ConfigurationManager verwenden.

Die Anwendung kann die System.Configuration-Typen erweitern oder diese direkt zur Behandlung von Konfigurationsinformationen verwenden, wie in der folgenden Liste erklärt wird:

• Behandeln der Konfiguration. Verwenden Sie beim Behandeln von Konfigurationsinformationen mit den Standardtypen einen der folgenden Ansätze:

  • Zugreifen auf einen Abschnitt. Um auf die Konfigurationsinformationen der Anwendung zuzugreifen, sollten Sie eine der von WebConfigurationManager bereitgestellten GetSection-Methoden verwenden. Für appSettings und connectionStrings sollten Sie die AppSettings-Eigenschaft und die ConnectionStrings-Eigenschaft verwenden. Diese Methoden führen schreibgeschützte Vorgänge mit einer einzigen zwischengespeicherten Instanz der Konfiguration aus und sind multithreadfähig.

  • Zugreifen auf Konfigurationsdateien. Ihre Anwendung kann Konfigurationseinstellungen auf allen Ebenen lokal oder remote für sich selbst oder andere Anwendungen und Computer lesen und schreiben. Sie verwenden eine der open-Methoden, die von WebConfigurationManager zur Verfügung gestellt werden. Diese Methoden geben ein Configuration-Objekt zurück, das wiederum die zum Behandeln der zugrunde liegenden Konfigurationsdateien erforderlichen Methoden und Eigenschaften bereitstellt. Diese Methoden führen Lese- oder Schreibvorgänge durch und erstellen die Konfigurationsdaten immer neu, wenn eine Datei geöffnet wird.

  • Erweiterte Konfiguration. Die Behandlung von erweiterten Konfigurationen wird durch folgende Typen bereitgestellt:SectionInformation, PropertyInformation, PropertyInformationCollection, ElementInformation, ContextInformation, ConfigurationSectionGroup, ConfigurationSectionGroupCollection und WebConfigurationSectionGroup.

• Erweitern von Konfigurationsstandardtypen. Benutzerdefinierte Konfigurationselemente können auch bereitgestellt werden, indem Standardkonfigurationstypen wie ConfigurationElement, ConfigurationElementCollection, ConfigurationProperty und ConfigurationSection mithilfe eines programmgesteuerten oder eines attributierten Modells erweitert werden. Ein Beispiel zum programmgesteuerten Erweitern eines Standardkonfigurationstyps finden Sie unter ConfigurationSection. Ein Beispiel zum Erweitern eines Standardkonfigurationstyps mithilfe des attributierten Modells finden Sie unter ConfigurationElement.

Hinweise für Implementierer Configuration ist die Klasse, die den programmgesteuerten Zugriff für das Bearbeiten von Konfigurationsdateien ermöglicht. Sie verwenden eine der offenen Methoden, die von WebConfigurationManager zur Verfügung gestellt werden. Diese Methoden geben ein Configuration-Objekt zurück, das wiederum die zum Behandeln der zugrunde liegenden Konfigurationsdateien erforderlichen Methoden und Eigenschaften bereitstellt. Sie können auf diese Dateien zum Lesen oder Schreiben wie folgt zugreifen:

• Lesen. Sie verwenden GetSection oder GetSectionGroup, um Konfigurationsinformationen zu lesen. Beachten Sie, dass der Benutzer oder der Prozess, der liest, die folgenden Berechtigungen haben muss:

  • Leseberechtigung für die Konfigurationsdatei auf der aktuellen Ebene der Konfigurationshierarchie.

  • Leseberechtigungen für alle übergeordneten Konfigurationsdateien.

Hinweis
Wenn Sie eine statische GetSection-Methode verwenden, die einen Pfadparameter annimmt, muss sich der Pfadparameter auf die Anwendung beziehen, in der der Code ausgeführt wird. Andernfalls wird der Parameter ignoriert, und es werden Konfigurationsinformationen für die derzeit ausgeführte Anwendung zurückgegeben.

• Schreiben. Verwenden Sie eine der Save-Methoden, um Konfigurationsinformationen zu schreiben. Beachten Sie, dass der Benutzer oder der Prozess, der schreibt, die folgenden Berechtigungen haben muss:

  • Schreibberechtigung für die Konfigurationsdatei und das Verzeichnis auf der aktuellen Ebene der Konfigurationshierarchie.

  • Leseberechtigungen für alle Konfigurationsdateien.

Im folgenden Codebeispiel wird veranschaulicht, wie mit der WebConfigurationManager-Methode auf Konfigurationsinformationen zugegriffen werden kann.

// Show the use of GetSection(string). 
// It gets the connectiobStrings section.
// If called from within a client application,
// the GetSection(string) gets the default connectionStrings
// section from the machine.config.
// If called from within a Web aplication it gets the
// section from the configuration file located at the 
// application current level. 
static void GetSection1()
{

    // 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();
}

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework