SectionInformation Třída

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v11.0.0-preview.5.26302.115

Zdroj:

SectionInformation.cs

Obsahuje metadata o jednotlivých oddílech v rámci hierarchie konfigurace. Tato třída se nemůže dědit.

public ref class SectionInformation sealed

public sealed class SectionInformation

type SectionInformation = class

Public NotInheritable Class SectionInformation

Dědičnost

Object

SectionInformation

Příklady

Následující příklad ukazuje, jak získat SectionInformation metadata, která jsou přidružena k objektu ConfigurationSection .

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

Následující příklad je výňatek konfiguračního souboru, který používá předchozí příklad.

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

Poznámky

Objekt SectionInformation obsahuje metadata o jednotlivých oddílech v rámci hierarchie konfigurace. Tento objekt lze použít k ověření a změně vlastností jednotlivého oddílu.

Vlastnosti

Name	Description
AllowDefinition	Získá nebo nastaví hodnotu, která indikuje, kde v hierarchii konfiguračního souboru může být definován přidružený konfigurační oddíl.
AllowExeDefinition	Získá nebo nastaví hodnotu, která indikuje, kde v hierarchii konfiguračního souboru lze deklarovat přidružený oddíl konfigurace.
AllowLocation	Získá nebo nastaví hodnotu, která označuje, zda oddíl konfigurace umožňuje location atribut.
AllowOverride	Získá nebo nastaví hodnotu, která označuje, zda přidružený konfigurační oddíl lze přepsat konfigurační soubory nižší úrovně.
ConfigSource	Získá nebo nastaví název zahrnutého souboru, ve kterém je definován přidružený konfigurační oddíl, pokud takový soubor existuje.
ForceSave	Získá nebo nastaví hodnotu, která označuje, zda přidružený konfigurační oddíl bude uložen, i když nebyl změněn.
InheritInChildApplications	Získá nebo nastaví hodnotu, která určuje, zda nastavení zadané v přidružené konfigurační části jsou zděděny aplikacemi, které se nacházejí v podadresáři příslušné aplikace.
IsDeclarationRequired	Získá hodnotu, která určuje, zda oddíl konfigurace musí být deklarován v konfiguračním souboru.
IsDeclared	Získá hodnotu, která určuje, zda přidružený konfigurační oddíl je deklarován v konfiguračním souboru.
IsLocked	Získá hodnotu, která označuje, zda přidružený oddíl konfigurace je uzamčen.
IsProtected	Získá hodnotu, která označuje, zda přidružený konfigurační oddíl je chráněn.
Name	Získá název přidruženého oddílu konfigurace.
OverrideMode	Získá nebo nastaví hodnotu výčtu OverrideMode , která určuje, zda přidružený konfigurační oddíl lze přepsat podřízenými konfiguračními soubory.
OverrideModeDefault	Získá nebo nastaví hodnotu, která určuje výchozí chování přepsání oddílu konfigurace podřízenými konfiguračními soubory.
OverrideModeEffective	Získá chování přepsání oddílu konfigurace, který je zase založen na tom, zda podřízené konfigurační soubory mohou uzamknout konfigurační oddíl.
ProtectionProvider	Získá chráněného zprostředkovatele konfigurace pro přidružený oddíl konfigurace.
RequirePermission	Získá hodnotu, která označuje, zda přidružený oddíl konfigurace vyžaduje přístupová oprávnění.
RestartOnExternalChanges	Získá nebo nastaví hodnotu, která určuje, zda změna externí konfigurační zahrnutí soubor vyžaduje restartování aplikace.
SectionName	Získá název přidruženého oddílu konfigurace.
Type	Získá nebo nastaví název třídy oddílu.

Metody

Name	Description
ForceDeclaration()	Vynutí, aby se přidružený oddíl konfigurace zobrazil v konfiguračním souboru.
ForceDeclaration(Boolean)	Vynutí zobrazení přidruženého konfiguračního oddílu v konfiguračním souboru nebo odebrání existujícího oddílu z konfiguračního souboru.
GetParentSection()	Získá konfigurační oddíl, který obsahuje oddíl konfigurace přidružený k tomuto objektu.
GetRawXml()	Vrátí objekt uzlu XML, který představuje přidružený objekt oddílu konfigurace.
ProtectSection(String)	Označí oddíl konfigurace pro ochranu.
RevertToParent()	Způsobí, že přidružený oddíl konfigurace dědí všechny jeho hodnoty z nadřazeného oddílu.
SetRawXml(String)	Nastaví objekt na reprezentaci XML přidruženého konfiguračního oddílu v konfiguračním souboru.
UnprotectSection()	Odebere chráněné šifrování konfigurace z přidružené části konfigurace.

Viz také

• ConfigurationSection