configuration-Element (allgemeines Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
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 sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
---|---|
xmlns |
Optionales String-Attribut. Gibt die 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. |
Gibt alle Elemente an, die zum ASP.NET-Konfigurationsschema gehören. |
|
Gibt alle Elemente an, die zum Schema für Starteinstellungen gehören. |
|
Gibt alle Elemente an, die zum Schema für Laufzeiteinstellungen gehören. |
|
Gibt alle Elemente an, die zum Schema für Remoteeinstellungen gehören. |
|
Gibt alle Elemente an, die zum Schema für Netzwerkeinstellungen gehören. |
|
Gibt alle Elemente an, die zum Schema für Kryptographieeinstellungen gehören. |
|
Gibt alle Elemente an, die zum Schema für Konfigurationsabschnittseinstellungen gehören. |
|
Gibt alle Elemente an, die zum Schema für Ablaufverfolgungs- und Debugeinstellungen gehören. |
|
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 |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer 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
Accessing ASP.NET Configuration Settings
Referenz
configSections-Element (allgemeines Einstellungsschema)
appSettings-Element (allgemeines Einstellungsschema)
connectionStrings-Element (ASP.NET-Einstellungsschema)
location-Element (ASP.NET-Einstellungsschema)
Konzepte
ASP.NET Configuration Overview
Format of ASP.NET Configuration Files
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen