configuration-Element (allgemeines Einstellungsschema)

Aktualisiert: November 2007

Das erforderliche Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

<configuration xmlns="schema URL">
   <!-- configuration settings -->
</configuration>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
xmlns	Optionales String-Attribut. Gibt den URL für das XML-Schema zur Validierung der Konfigurationsdatei an. Wenn dieses Attribut nicht festgelegt ist, können Sie in Microsoft Visual Studio nicht die Hilfe durch Drücken von F1 verwenden, um Themen über die Konfigurationselemente zu öffnen. Der Standardwert für ASP.NET, Version 2.0, ist "https://schemas.microsoft.com/.NetConfiguration/v2.0".

Untergeordnete Elemente

Element	Beschreibung
configSections	Legt Konfigurationsabschnitts- und Namespacedeklarationen fest.
appSettings	Enthält benutzerdefinierte Anwendungseinstellungen wie Dateipfade, XML-Webdienst-URLs oder sonstige Informationen, die in der INI-Datei einer Anwendung gespeichert sind.
connectionStrings	Gibt eine Auflistung von Verbindungszeichenfolgen für Datenbanken in ASP.NET-Anwendungen und ASP.NET-Features an (in Form von Name-Wert-Paaren).
location	Gibt die Ressource an, für die die untergeordneten Konfigurationseinstellungen gelten. Dieses Element sperrt auch Konfigurationseinstellungen, sodass die Einstellungen nicht von untergeordneten Konfigurationsdateien überschrieben werden können.
ASP.NET-Einstellungsschema	Gibt alle Elemente an, die zum ASP.NET-Konfigurationsschema gehören.
Schema für Starteinstellungen	Gibt alle Elemente an, die zum Schema für Starteinstellungen gehören.
Schema für Laufzeiteinstellungen	Gibt alle Elemente an, die zum Schema für Laufzeiteinstellungen gehören.
Schema für Remoteeinstellungen	Gibt alle Elemente an, die zum Schema für Remoteeinstellungen gehören.
Netzwerkeinstellungsschema	Gibt alle Elemente an, die zum Schema für Netzwerkeinstellungen gehören.
Schema für Kryptografieeinstellungen	Gibt alle Elemente an, die zum Schema für Kryptographieeinstellungen gehören.
Schema für Konfigurationsabschnitte	Gibt alle Elemente an, die zum Schema für Konfigurationsabschnittseinstellungen gehören.
Schema für Ablaufverfolgungs- und Debugeinstellungen	Gibt alle Elemente an, die zum Schema für Ablaufverfolgungs- und Debugeinstellungen gehören.
Einstellungsschema für XML-Webdienste	Gibt alle Elemente an, die zum Schema für Webdiensteinstellungen gehören.

Übergeordnete Elemente

Keine

Hinweise

Das configuration-Element ist das erforderliche Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

Jede Konfigurationsdatei muss exakt ein configuration-Element enthalten.

Standardkonfiguration

Das folgende Codebeispiel zeigt eine grundlegende Datei Web.config, die für jede beliebige ASP.NET-Anwendung erstellt werden kann. Der Abschnitt customErrors wird vorsorglich bereitgestellt, ist jedoch auskommentiert.

<?xml version="1.0"?>
<configuration 
   xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <compilation debug="false"/>
        <authentication mode="Windows"/>
        <!--
        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	Nicht vorhanden.
Konfigurationsmember	Configuration
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer Verzeichnisse
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 1.0, 1.1 oder 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuerter Zugriff auf die ASP.NET-Konfigurationseinstellungen

Konzepte

Übersicht über die ASP.NET-Konfiguration

Absichern der ASP.NET-Konfiguration

Bearbeiten von ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationsszenarios

Referenz

configSections-Element (allgemeines Einstellungsschema)

appSettings-Element (allgemeines Einstellungsschema)

connectionStrings-Element (ASP.NET-Einstellungsschema)

location-Element (ASP.NET-Einstellungsschema)

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurations-API

Konfigurationsdateien