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:
Durch Verwendung der Konfigurations-API von ASP.NET. Weitere Informationen finden Sie unter ASP.NET-Konfigurations-API.
Durch Verwendung des ASP.NET-MMC-Snap-Ins.
Durch Verwendung des Websiteverwaltungs-Tools für Websites und ASP.NET-Anwendungen. Weitere Informationen finden Sie unter ASP.NET-Websiteverwaltungs-Tool.
Mit einem Text-Editor oder einem XML-Editor für die direkte Bearbeitung der Konfigurationsdateien. Informationen über die richtige Syntax finden Sie in den Konfigurationsreferenzthemen, die in ASP.NET-Konfigurationseinstellungen und Allgemeine Konfigurationseinstellungen (ASP.NET) aufgelistet sind.
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