Von Abschnittselementen geerbte allgemeine Attribute
Konfigurationseinstellungen werden von ASP.NET in hierarchischer Abfolge auf Ressourcen angewendet. Konfigurationseinstellungen werden von übergeordneten Konfigurationsdateien geerbt. Dieses Thema listet mehrere allgemeine Attribute auf, die von allen Abschnittselementen geerbt werden.
Abschnittselemente
Abschnittselemente sind Member von Konfigurationsabschnitten. Dies umfasst keine Elemente, die Member von Konfigurationsabschnittsgruppen sind.
Konfigurationsabschnittsdeklarationen werden im configSections-Element am Anfang der Konfigurationsdatei angezeigt. Jede in einem section-Element enthaltene Deklaration legt den Namen eines Abschnitts und den Namen der von ConfigurationSection abgeleiteten .NET Framework-Klasse fest, die Konfigurationsdaten in diesem Abschnitt verarbeitet. section-Tags können in sectionGroup-Tags gruppiert werden.
Weitere Informationen finden Sie unter ASP.NET-Konfigurationsdateien oder Bearbeiten von ASP.NET-Konfigurationsdateien.
Allgemeine Attribute
In der folgenden Tabelle werden die allgemeinen Attribute beschrieben, die für jedes Abschnittselement festgelegt werden können. Diese allgemeinen Attribute werden auch von untergeordneten Elementen der Abschnittselemente geerbt. Alle Attribute mit dem Wort lock im Namen dienen dazu, den angegebenen Inhalt in der Konfigurationsdatei vor Änderungen zu schützen. Standardmäßig sind Elemente und Attribute nicht gesperrt.
Attribut |
Beschreibung |
---|---|
configSource |
Optionales String-Attribut. Legt den Namen der Include-Datei (falls vorhanden) fest, in der der entsprechende Konfigurationsabschnitt definiert ist. Über die ConfigSource-Eigenschaft kann programmgesteuert darauf zugegriffen werden. Wenn Sie das configSource-Attribut verwenden, müssen Sie den gesamten Abschnitt in eine separate Datei einfügen, da die Elementeinstellungen nicht zusammengeführt werden. Standardmäßig wird bei jeder Änderung der externen Datei die Anwendung neu gestartet. Damit die Anwendung nicht bei jeder Änderung neu gestartet wird, können Sie das section-Element für configSections (allgemeines Einstellungsschema) in der Datei Web.config konfigurieren und dessen restartOnExternalChanges-Attribut auf false festlegen. |
lockAllAttributesExcept |
Optionales String-Attribut; als Wert kann eine durch Kommas getrennte Liste angegeben werden. Sperrt bis auf die angegebenen Attribute alle Attribute des übergeordneten Elements. Über die LockAllAttributesExcept-Eigenschaft kann programmgesteuert darauf zugegriffen werden. Von niedrigeren Ebenen der Konfigurationshierarchie aus können keine Ebenen gesperrt werden, die sich in der Hierarchie weiter oben befinden. |
lockAllElementsExcept |
Optionales String-Attribut; als Wert kann eine durch Kommas getrennte Liste angegeben werden. Sperrt bis auf die angegebenen Elemente alle untergeordneten Elemente des übergeordneten Elements. Über die LockAllElementsExcept-Eigenschaft kann programmgesteuert darauf zugegriffen werden. |
lockAttributes |
Optionales String-Attribut; als Wert kann eine durch Kommas getrennte Liste angegeben werden. Sperrt alle Attribute des übergeordneten Elements. Über die LockAttributes-Eigenschaft kann programmgesteuert darauf zugegriffen werden. |
lockElements |
Optionales String-Attribut; als Wert kann eine durch Kommas getrennte Liste angegeben werden. Sperrt alle untergeordneten Elemente des übergeordneten Elements. Über die LockElements-Eigenschaft kann programmgesteuert darauf zugegriffen werden. |
lockItem |
Optionales String-Attribut. Hat den Wert true, wenn das Element, in dem das Attribut vorkommt, gesperrt sein muss; andernfalls hat es den Wert false. Der Standardwert ist false. Sie können mit diesem Attribut nicht nur jedes beliebige einzelne Element sperren, sondern auch bestimmte Auflistungselemente in einer bestimmten Auflistung. Sie können mit dem Attribut auch ganze Abschnitte sperren. Über die LockItem-Eigenschaft kann programmgesteuert darauf zugegriffen werden. |
Beispiel
Das folgende Codebeispiel ist ein Teil der Datei machine.config. Konfigurationsabschnittshandler werden für die system.web-Abschnittsgruppe und den anonymousIdentification-Abschnitt deklariert. Darunter werden das system.Web-Konfigurationselement und das anonymousIdentification-Konfigurationselement deklariert.
Das system.Web-Konfigurationselement ist Member einer Konfigurationsabschnittsgruppe und enthält demnach keine Attribute.
Das anonymousIdentification-Konfigurationselement ist Member eines Konfigurationsabschnitts und erbt demnach die in der vorherigen Tabelle aufgeführten Attribute. Beachten Sie, dass dem configSource-Attribut eine externe Datei zugeordnet ist (für den Elementinhalt) und das lockItem-Attribut auf true festgelegt ist, um Inhaltsänderungen zu verhindern.
<configuration>
<configSections>
<!-- Other configuration sections. -->
<sectionGroup name="system.web" ...>
<section name="anonymousIdentification" ... />
</sectionGroup>
</configSections>
<system.web>
<anonymousIdentification configSource="IDSourceFile.xml"
lockItem="true" />
</system.web>
</configuration>
Siehe auch
Aufgaben
Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen
Konzepte
Übersicht über die ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Absichern der ASP.NET-Konfiguration
Bearbeiten von ASP.NET-Konfigurationsdateien