SectionInformation Klasse

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

SectionInformation.cs

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

Object

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.
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.

Weitere Informationen

• ConfigurationSection