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

Weitere Ressourcen

ASP.NET-Konfigurationsdateien