Freigeben über


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