Freigeben über


Bearbeiten von ASP.NET-Konfigurationsdateien

Aktualisiert: November 2007

ASP.NET-Konfigurationsdaten werden in XML-Textdateien gespeichert, die alle den Namen Web.config erhalten. Die Dateien Web.config können in ASP.NET-Anwendungen in mehreren Verzeichnissen vorkommen. Die Konfigurationseinstellungen in den einzelnen Web.config-Dateien werden nur auf das zur Datei gehörige Verzeichnis und alle untergeordneten Verzeichnisse angewendet. Einstellungen in übergeordneten Verzeichnissen können mit den Einstellungen aus untergeordneten Verzeichnissen optional überschrieben oder geändert werden. Der Stamm der ASP.NET-Konfigurationshierarchie ist die Datei Systemstamm\Microsoft.NET\Framework\versionNumber\CONFIG\Web.config, Hier sind die Einstellungen gespeichert, die auf alle ASP.NET-Anwendungen einer bestimmten Microsoft .NET Framework-Version angewendet werden. Da jede ASP.NET-Anwendung die Standardkonfigurationseinstellungen von der Stammdatei Web.config erbt, müssen Sie die Dateien Web.config nur für diejenigen Einstellungen erstellen, die die Standardeinstellungen überschreiben.

Struktur der Konfigurationsdatei

Jede Konfigurationsdatei enthält geschachtelte XML-Tags und -Untertags mit Attributen, die die Konfigurationseinstellungen angeben. Alle Konfigurationsinformationen befinden sich zwischen den Stamm-XML-Tags <configuration> und </configuration>. Die Konfigurationsinformationen innerhalb dieser Tags sind in zwei Hauptbereiche untergliedert: den Deklarationsbereich des Konfigurationsabschnittshandlers und den Bereich mit Konfigurationsabschnittseinstellungen. Weitere Informationen finden Sie unter Struktur der ASP.NET-Konfigurationsdatei (Abschnitte und Abschnittshandler).

Bearbeiten von Konfigurationseinstellungen

Da es sich um Klartext-XML-Dateien handelt, können Sie Konfigurationseinstellungen folgendermaßen erstellen oder bearbeiten:

Berücksichtigung der Groß-/Kleinschreibung

Da es sich bei den Tags um wohlgeformten XML-Code handeln muss, wird bei Tags, untergeordneten Tags und Attributen zwischen Groß-/Kleinschreibung unterschieden. Tagnamen und Attributnamen werden in Kamel-Schreibweise verfasst. Dies bedeutet, dass das erste Zeichen eines Tagnamens ein Kleinbuchstabe und das erste Zeichen aller nachfolgenden, damit verketteten Wörter ein Großbuchstabe ist. In den meisten Fällen sind Zeichenfolgen-Attributwerte in der Pascal-Schreibweise gehalten, d. h., das erste Zeichen und das erste Zeichen aller nachfolgenden, damit verketteten Wörter ist ein Großbuchstabe. Ausnahmen sind true und false, die immer klein geschrieben sind.

Benutzerdefinierte Abschnitte

Seitens der ASP.NET-Konfigurationsinfrastruktur bestehen keine Einschränkungen im Hinblick auf die Konfigurationsdatentypen, die von der Infrastruktur unterstützt werden. Die Klassen für Konfigurationsabschnittshandler verarbeiten alle in der Datei Web.config enthaltenen Daten. Sie können die mit .NET Framework bereitgestellten, vordefinierten Konfigurationsabschnittshandler verwenden oder eigene Handler zur Verarbeitung benutzerdefinierter Konfigurationsdaten erstellen.

Weitere Informationen zum Erstellen benutzerdefinierter Konfigurationstypen finden Sie unter Gewusst wie: Erstellen von benutzerdefinierten Konfigurationsabschnitten mit ConfigurationSection.

Bearbeiten von Remotekonfigurationsdateien

Mithilfe der ASP.NET-Konfigurations-API kann eine Anwendung die Konfigurationsdateien auf einem Remotecomputer ändern. Insbesondere können Sie die Datei Machine.config oder Web.config in jeder Microsoft IIS-Anwendung oder ihren untergeordneten Verzeichnissen auf einem Remotecomputer ändern. Wenn die Datei Web.config nicht vorhanden ist, bestehen die zurückgegebenen Konfigurationsdaten ausschließlich aus geerbten Einstellungen für den angegebenen Pfad. Wenn die Anwendung eine Aktualisierung der zurückgegebenen Konfigurationsdaten anfordert, wird eine neue Datei erstellt. Weitere Informationen finden Sie unter Bearbeiten von ASP.NET-Remotekonfigurationsdateien und Gewusst wie: Öffnen und Ändern von ASP.NET-Konfigurationsdateien über Remotezugriff.

Durch Konfigurationsänderungen verursachter Neustart der Anwendungsdomäne

Änderungen an den Konfigurationseinstellungen in Web.config-Dateien verursachen indirekt einen Neustart der Anwendungsdomäne. Dieses Verhalten ist im System vorgesehen. Optional können Sie mit dem configSource-Attribut auf externe Konfigurationsdateien verweisen, die bei Änderungen keinen Neustart verursachen. Weitere Informationen finden Sie in Allgemeine von Abschnittselementen geerbte Attribute unter configSource.

Versuche von Benutzern, ohne Berechtigung eine Konfigurationsdatei zu ändern, verursachen keinen Neustart der Anwendungsdomäne.

Weitere Informationen hierzu finden Sie unter Verwalten von Änderungen an Konfigurationseinstellungen.

Siehe auch

Aufgaben

Gewusst wie: Öffnen und Ändern von ASP.NET-Konfigurationsdateien über Remotezugriff

Gewusst wie: Erstellen von benutzerdefinierten Konfigurationsabschnitten mit ConfigurationSection

Konzepte

Absichern der ASP.NET-Konfiguration

Bearbeiten von ASP.NET-Remotekonfigurationsdateien

Verwalten von Änderungen an Konfigurationseinstellungen

Referenz

.NET Framework-Tools

Weitere Ressourcen

Verwalten von ASP.NET-Websites

Konfigurieren von .NET Framework-Anwendungen