Freigeben über


SectionInformation Klasse

Definition

Enthält Metadaten zu einem einzelnen Abschnitt innerhalb der Konfigurationshierarchie. Diese Klasse kann nicht vererbt werden.

public ref class SectionInformation sealed
public sealed class SectionInformation
type SectionInformation = class
Public NotInheritable Class SectionInformation
Vererbung
SectionInformation

Beispiele

Das folgende Beispiel zeigt, wie Sie die Metadaten abrufen, die SectionInformation einem ConfigurationSection -Objekt zugeordnet sind.

static public SectionInformation 
    GetSectionInformation()
{

    // Get the current configuration file.
    System.Configuration.Configuration config =
            ConfigurationManager.OpenExeConfiguration(
            ConfigurationUserLevel.None);

    // Get the section.
    UrlsSection section =
        (UrlsSection)config.GetSection("MyUrls");

    SectionInformation sInfo = 
        section.SectionInformation;

    return sInfo;
}
Public Shared Function GetSectionInformation() _
As SectionInformation

    ' Get the current configuration file.
    Dim config _
    As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
    ConfigurationUserLevel.None)

    ' Get the section.
    Dim section As UrlsSection = _
    CType(config.GetSection("MyUrls"), UrlsSection)

    Dim sInfo As SectionInformation = _
    section.SectionInformation

    Return sInfo

End Function 'GetSectionInformation

Das folgende Beispiel ist ein Auszug der Konfigurationsdatei, die im vorherigen Beispiel verwendet wird.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="MyUrls" type="Samples.AspNet.UrlsSection,
      ConfigurationElement, Version=1.0.0.0, Culture=neutral,
      PublicKeyToken=null" allowDefinition="Everywhere"
      allowExeDefinition="MachineToApplication"
      restartOnExternalChanges="true" />
  </configSections>
  <MyUrls name="MyFavorites">
    <simple name="Contoso" url="http://www.contoso.com" port="8080" />
    <urls>
      <clear />
      <add name="Microsoft" url="http://www.microsoft.com" port="0" />
    </urls>
  </MyUrls>
</configuration>

Hinweise

Das SectionInformation -Objekt enthält die Metadaten zu einem einzelnen Abschnitt innerhalb der Konfigurationshierarchie. Dieses Objekt kann verwendet werden, um die Eigenschaften eines einzelnen Abschnitts zu überprüfen und zu ändern.

Eigenschaften

AllowDefinition

Ruft einen Wert ab, der angibt, wo der zugeordnete Konfigurationsabschnitt in der Hierarchie der Konfigurationsdatei definiert werden kann, oder legt diesen fest.

AllowExeDefinition

Ruft einen Wert ab, der angibt, wo der zugeordnete Konfigurationsabschnitt in der Hierarchie der Konfigurationsdatei deklariert werden kann, oder legt diesen fest.

AllowLocation

Ruft einen Wert ab, der angibt, ob der Konfigurationsabschnitt das location-Attribut zulässt, oder legt diesen fest.

AllowOverride

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt von Konfigurationsdateien niedrigerer Ebene überschrieben werden kann, oder legt diesen fest.

ConfigSource

Ruft den Namen der Includedatei ab, in der der zugeordnete Konfigurationsabschnitt definiert ist, sofern eine solche Datei vorhanden ist, oder legt diesen fest.

ConfigurationBuilder

Ruft das ConfigurationBuilder-Objekt aus dem Konfigurationsabschnitt auf.

ForceSave

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt auch dann gespeichert wird, wenn er nicht geändert wurde, oder legt diesen fest.

InheritInChildApplications

Ruft einen Wert ab, der angibt, ob die im zugeordneten Konfigurationsabschnitt angegebenen Einstellungen von Anwendungen geerbt werden, die sich in einem Unterverzeichnis der entsprechenden Anwendung befinden, oder legt diesen fest.

IsDeclarationRequired

Ruft einen Wert ab, der angibt, ob der Konfigurationsabschnitt in der Konfigurationsdatei deklariert werden muss.

IsDeclared

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei deklariert wird.

IsLocked

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt gesperrt ist.

IsProtected

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt geschützt ist.

Name

Ruft den Namen des zugeordneten Konfigurationsabschnitts ab.

OverrideMode

Ruft den OverrideMode-Enumerationswert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt von untergeordneten Konfigurationsdateien überschrieben werden kann, oder legt diesen fest.

OverrideModeDefault

Ruft einen Wert ab, der das Standardüberschreibungsverhalten untergeordneter Konfigurationsdateien für einen Konfigurationsabschnitt angibt, oder legt diesen fest.

OverrideModeEffective

Ruft das Überschreibungsverhalten eines Konfigurationsabschnitts ab, das davon abhängt, ob untergeordnete Konfigurationsdateien den Konfigurationsabschnitt sperren können, oder legt diesen fest.

ProtectionProvider

Ruft den Anbieter für geschützte Konfigurationen für den zugeordneten Konfigurationsabschnitt ab.

RequirePermission

Ruft einen Wert ab, der angibt, ob für den zugeordneten Konfigurationsabschnitt Zugriffsberechtigungen erforderlich sind.

RestartOnExternalChanges

Ruft einen Wert ab, der angibt, ob für eine Änderung in einer externen Konfigurationsincludedatei ein Neustart der Anwendung erforderlich ist, oder legt diesen fest.

SectionName

Ruft den Namen des zugeordneten Konfigurationsabschnitts ab.

Type

Ruft den Namen der Abschnittsklasse ab oder legt diesen fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ForceDeclaration()

Erzwingt, dass der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei steht.

ForceDeclaration(Boolean)

Erzwingt, dass der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei enthalten ist, oder entfernt einen vorhandenen Abschnitt aus der Konfigurationsdatei.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetParentSection()

Ruft den Konfigurationsabschnitt ab, der den diesem Objekt zugeordneten Konfigurationsabschnitt enthält.

GetRawXml()

Gibt ein XML-Knotenobjekt zurück, das das zugeordnete Konfigurationsabschnittsobjekt darstellt.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ProtectSection(String)

Markiert einen Konfigurationsabschnitt zum Schutz.

RevertToParent()

Bewirkt, dass der zugeordnete Konfigurationsabschnitt alle Werte vom übergeordneten Abschnitt erbt.

SetRawXml(String)

Legt das Objekt auf eine XML-Darstellung des zugeordneten Konfigurationsabschnitts in der Konfigurationsdatei fest.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
UnprotectSection()

Entfernt die Verschlüsselung der geschützten Konfiguration aus dem zugeordneten Konfigurationsabschnitt.

Gilt für:

Weitere Informationen