SectionInformation Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Enthält Metadaten zu einem einzelnen Abschnitt in der Konfigurationshierarchie. Diese Klasse kann nicht vererbt werden.
public ref class SectionInformation sealedpublic sealed class SectionInformationtype SectionInformation = classPublic NotInheritable Class SectionInformation- Vererbung
-
SectionInformation
Beispiele
Das folgende Beispiel zeigt, wie Die Metadaten abgerufen werden, 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 vom 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 in der Konfigurationshierarchie. Dieses Objekt kann verwendet werden, um die Eigenschaften eines einzelnen Abschnitts zu überprüfen und zu ändern.
Eigenschaften
| Name | Beschreibung |
|---|---|
| AllowDefinition |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo in der Konfigurationsdateihierarchie der zugeordnete Konfigurationsabschnitt definiert werden kann. |
| AllowExeDefinition |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, wo in der Konfigurationsdateihierarchie der zugeordnete Konfigurationsabschnitt deklariert werden kann. |
| AllowLocation |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Konfigurationsabschnitt das |
| AllowOverride |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der zugeordnete Konfigurationsabschnitt durch Konfigurationsdateien auf niedrigerer Ebene überschrieben werden kann. |
| ConfigSource |
Ruft den Namen der Includedatei ab, in der der zugehörige Konfigurationsabschnitt definiert ist, wenn eine solche Datei vorhanden ist, oder legt diesen fest. |
| ConfigurationBuilder |
Ruft das ConfigurationBuilder Objekt für diesen Konfigurationsabschnitt ab. |
| ForceSave |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der zugeordnete Konfigurationsabschnitt gespeichert wird, auch wenn er nicht geändert wurde. |
| InheritInChildApplications |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die im zugeordneten Konfigurationsabschnitt angegebenen Einstellungen von Anwendungen geerbt werden, die sich in einem Unterverzeichnis der relevanten Anwendung befinden. |
| 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 |
Dient zum Abrufen oder Festlegen des Enumerationswerts, der OverrideMode angibt, ob der zugeordnete Konfigurationsabschnitt von untergeordneten Konfigurationsdateien außer Kraft gesetzt werden kann. |
| OverrideModeDefault |
Dient zum Abrufen oder Festlegen eines Werts, der das Standardüberschreibungsverhalten eines Konfigurationsabschnitts nach untergeordneten Konfigurationsdateien angibt. |
| OverrideModeEffective |
Ruft das Außerkraftsetzungsverhalten eines Konfigurationsabschnitts ab, der wiederum darauf basiert, ob untergeordnete Konfigurationsdateien den Konfigurationsabschnitt sperren können. |
| ProtectionProvider |
Ruft den geschützten Konfigurationsanbieter für den zugeordneten Konfigurationsabschnitt ab. |
| RequirePermission |
Ruft einen Wert ab, der angibt, ob der zugeordnete Konfigurationsabschnitt Zugriffsberechtigungen erfordert. |
| RestartOnExternalChanges |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Änderung in einer externen Konfiguration eine Datei erfordert einen Anwendungsneustart. |
| SectionName |
Ruft den Namen des zugeordneten Konfigurationsabschnitts ab. |
| Type |
Dient zum Abrufen oder Festlegen des Abschnittsklassennamens. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| ForceDeclaration() |
Erzwingt die Anzeige des zugeordneten Konfigurationsabschnitts in der Konfigurationsdatei. |
| ForceDeclaration(Boolean) |
Erzwingt, dass der zugeordnete Konfigurationsabschnitt in der Konfigurationsdatei angezeigt wird, oder entfernt einen vorhandenen Abschnitt aus der Konfigurationsdatei. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetParentSection() |
Ruft den Konfigurationsabschnitt ab, der den konfigurationsabschnitt enthält, der diesem Objekt zugeordnet ist. |
| GetRawXml() |
Gibt ein XML-Knotenobjekt zurück, das das zugeordnete Konfigurationsabschnittsobjekt darstellt. |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ProtectSection(String) |
Markiert einen Konfigurationsabschnitt zum Schutz. |
| RevertToParent() |
Bewirkt, dass der zugeordnete Konfigurationsabschnitt alle zugehörigen 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 geschützte Konfigurationsverschlüsselung aus dem zugehörigen Konfigurationsabschnitt. |
