SectionInformation SectionInformation SectionInformation SectionInformation Class

Definition

Enthält Metadaten zu einem einzelnen Abschnitt innerhalb der Konfigurationshierarchie.Contains metadata about an individual section within the configuration hierarchy. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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

Beispiele

Das folgende Beispiel zeigt, wie Sie erhalten die SectionInformation Metadaten, die zugeordnet ist eine ConfigurationSection Objekt.The following example shows how to get the SectionInformation metadata that is associated with a ConfigurationSection object.

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
 

Im folgende Beispiel wird ein Auszug aus der Konfigurationsdatei, die im vorherigen Beispiel verwendet wird.The following example is an excerpt of the configuration file that is used by the previous example.

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

Die SectionInformation Objekt enthält die Metadaten zu einem einzelnen Abschnitt innerhalb der Hierarchie.The SectionInformation object contains the metadata about an individual section within the configuration hierarchy. Dieses Objekt kann verwendet werden, um zu überprüfen und Ändern der Eigenschaften eines einzelne Abschnitts.This object can be used in order to validate and change the properties of an individual section.

Eigenschaften

AllowDefinition AllowDefinition AllowDefinition AllowDefinition

Ruft einen Wert ab, der angibt, wo der zugeordnete Konfigurationsabschnitt in der Hierarchie der Konfigurationsdatei definiert werden kann, oder legt diesen fest.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be defined.

AllowExeDefinition AllowExeDefinition AllowExeDefinition AllowExeDefinition

Ruft einen Wert ab, der angibt, wo der zugeordnete Konfigurationsabschnitt in der Hierarchie der Konfigurationsdatei deklariert werden kann, oder legt diesen fest.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be declared.

AllowLocation AllowLocation AllowLocation AllowLocation

Ruft einen Wert ab, der angibt, ob der Konfigurationsabschnitt das location-Attribut zulässt, oder legt diesen fest.Gets or sets a value that indicates whether the configuration section allows the location attribute.

AllowOverride AllowOverride AllowOverride AllowOverride

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt von Konfigurationsdateien niedrigerer Ebene überschrieben werden kann, oder legt diesen fest.Gets or sets a value that indicates whether the associated configuration section can be overridden by lower-level configuration files.

ConfigSource ConfigSource ConfigSource ConfigSource

Ruft den Namen der Includedatei ab, in der der zugeordnete Konfigurationsabschnitt definiert ist, sofern eine solche Datei vorhanden ist, oder legt diesen fest.Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

ConfigurationBuilder ConfigurationBuilder ConfigurationBuilder ConfigurationBuilder

Ruft das ConfigurationBuilder-Objekt aus dem Konfigurationsabschnitt auf.Gets the ConfigurationBuilder object for this configuration section.

ForceSave ForceSave ForceSave 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.Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

InheritInChildApplications InheritInChildApplications InheritInChildApplications 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.Gets or sets a value that indicates whether the settings that are specified in the associated configuration section are inherited by applications that reside in a subdirectory of the relevant application.

IsDeclarationRequired IsDeclarationRequired IsDeclarationRequired IsDeclarationRequired

Ruft einen Wert ab, der angibt, ob der Konfigurationsabschnitt in der Konfigurationsdatei deklariert werden muss.Gets a value that indicates whether the configuration section must be declared in the configuration file.

IsDeclared IsDeclared IsDeclared IsDeclared

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei deklariert wird.Gets a value that indicates whether the associated configuration section is declared in the configuration file.

IsLocked IsLocked IsLocked IsLocked

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt gesperrt ist.Gets a value that indicates whether the associated configuration section is locked.

IsProtected IsProtected IsProtected IsProtected

Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt geschützt ist.Gets a value that indicates whether the associated configuration section is protected.

Name Name Name Name

Ruft den Namen des zugeordneten Konfigurationsabschnitts ab.Gets the name of the associated configuration section.

OverrideMode OverrideMode OverrideMode OverrideMode

Ruft den OverrideMode-Enumerationswert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt von untergeordneten Konfigurationsdateien überschrieben werden kann, oder legt diesen fest.Gets or sets the OverrideMode enumeration value that specifies whether the associated configuration section can be overridden by child configuration files.

OverrideModeDefault OverrideModeDefault OverrideModeDefault OverrideModeDefault

Ruft einen Wert ab, der das Standardüberschreibungsverhalten untergeordneter Konfigurationsdateien für einen Konfigurationsabschnitt angibt, oder legt diesen fest.Gets or sets a value that specifies the default override behavior of a configuration section by child configuration files.

OverrideModeEffective OverrideModeEffective OverrideModeEffective OverrideModeEffective

Ruft das Überschreibungsverhalten eines Konfigurationsabschnitts ab, das davon abhängt, ob untergeordnete Konfigurationsdateien den Konfigurationsabschnitt sperren können, oder legt diesen fest.Gets the override behavior of a configuration section that is in turn based on whether child configuration files can lock the configuration section.

ProtectionProvider ProtectionProvider ProtectionProvider ProtectionProvider

Ruft den Anbieter für geschützte Konfigurationen für den zugeordneten Konfigurationsabschnitt ab.Gets the protected configuration provider for the associated configuration section.

RequirePermission RequirePermission RequirePermission RequirePermission

Ruft einen Wert ab, der angibt, ob für den zugeordneten Konfigurationsabschnitt Zugriffsberechtigungen erforderlich sind.Gets a value that indicates whether the associated configuration section requires access permissions.

RestartOnExternalChanges RestartOnExternalChanges RestartOnExternalChanges 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.Gets or sets a value that specifies whether a change in an external configuration include file requires an application restart.

SectionName SectionName SectionName SectionName

Ruft den Namen des zugeordneten Konfigurationsabschnitts ab.Gets the name of the associated configuration section.

Type Type Type Type

Ruft den Namen der Abschnittsklasse ab oder legt diesen fest.Gets or sets the section class name.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ForceDeclaration() ForceDeclaration() ForceDeclaration() ForceDeclaration()

Erzwingt, dass der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei steht.Forces the associated configuration section to appear in the configuration file.

ForceDeclaration(Boolean) ForceDeclaration(Boolean) ForceDeclaration(Boolean) ForceDeclaration(Boolean)

Erzwingt, dass der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei enthalten ist, oder entfernt einen vorhandenen Abschnitt aus der Konfigurationsdatei.Forces the associated configuration section to appear in the configuration file, or removes an existing section from the configuration file.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetParentSection() GetParentSection() GetParentSection() GetParentSection()

Ruft den Konfigurationsabschnitt ab, der den diesem Objekt zugeordneten Konfigurationsabschnitt enthält.Gets the configuration section that contains the configuration section associated with this object.

GetRawXml() GetRawXml() GetRawXml() GetRawXml()

Gibt ein XML-Knotenobjekt zurück, das das zugeordnete Konfigurationsabschnittsobjekt darstellt.Returns an XML node object that represents the associated configuration-section object.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ProtectSection(String) ProtectSection(String) ProtectSection(String) ProtectSection(String)

Markiert einen Konfigurationsabschnitt zum Schutz.Marks a configuration section for protection.

RevertToParent() RevertToParent() RevertToParent() RevertToParent()

Bewirkt, dass der zugeordnete Konfigurationsabschnitt alle Werte vom übergeordneten Abschnitt erbt.Causes the associated configuration section to inherit all its values from the parent section.

SetRawXml(String) SetRawXml(String) SetRawXml(String) SetRawXml(String)

Legt das Objekt auf eine XML-Darstellung des zugeordneten Konfigurationsabschnitts in der Konfigurationsdatei fest.Sets the object to an XML representation of the associated configuration section within the configuration file.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
UnprotectSection() UnprotectSection() UnprotectSection() UnprotectSection()

Entfernt die geschützte Konfigurationsverschlüsselung aus dem zugeordneten Konfigurationsabschnitt.Removes the protected configuration encryption from the associated configuration section.

Gilt für:

Siehe auch