Udostępnij za pośrednictwem


SectionInformation Klasa

Definicja

Zawiera metadane dotyczące poszczególnych sekcji w hierarchii konfiguracji. Klasa ta nie może być dziedziczona.

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

Przykłady

W poniższym przykładzie pokazano, jak pobrać SectionInformation metadane skojarzone z obiektem 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

Poniższy przykład to fragment pliku konfiguracji, który jest używany przez poprzedni przykład.

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

Uwagi

Obiekt SectionInformation zawiera metadane dotyczące poszczególnych sekcji w hierarchii konfiguracji. Ten obiekt może służyć do weryfikowania i zmieniania właściwości pojedynczej sekcji.

Właściwości

AllowDefinition

Pobiera lub ustawia wartość wskazującą, gdzie w hierarchii plików konfiguracji można zdefiniować skojarzona sekcja konfiguracji.

AllowExeDefinition

Pobiera lub ustawia wartość wskazującą, gdzie w hierarchii plików konfiguracji można zadeklarować skojarzona sekcja konfiguracji.

AllowLocation

Pobiera lub ustawia wartość wskazującą, czy sekcja konfiguracji zezwala na location atrybut.

AllowOverride

Pobiera lub ustawia wartość wskazującą, czy skojarzona sekcja konfiguracji może zostać zastąpiona przez pliki konfiguracji niższego poziomu.

ConfigSource

Pobiera lub ustawia nazwę pliku dołączania, w którym zdefiniowano skojarzą sekcję konfiguracji, jeśli taki plik istnieje.

ConfigurationBuilder

ConfigurationBuilder Pobiera obiekt dla tej sekcji konfiguracji.

ForceSave

Pobiera lub ustawia wartość wskazującą, czy skojarzona sekcja konfiguracji zostanie zapisana, nawet jeśli nie została zmodyfikowana.

InheritInChildApplications

Pobiera lub ustawia wartość wskazującą, czy ustawienia określone w skojarzonej sekcji konfiguracji są dziedziczone przez aplikacje znajdujące się w podkatalogu odpowiedniej aplikacji.

IsDeclarationRequired

Pobiera wartość wskazującą, czy sekcja konfiguracji musi być zadeklarowana w pliku konfiguracji.

IsDeclared

Pobiera wartość wskazującą, czy skojarzona sekcja konfiguracji jest zadeklarowana w pliku konfiguracji.

IsLocked

Pobiera wartość wskazującą, czy skojarzona sekcja konfiguracji jest zablokowana.

IsProtected

Pobiera wartość wskazującą, czy skojarzona sekcja konfiguracji jest chroniona.

Name

Pobiera nazwę skojarzonej sekcji konfiguracji.

OverrideMode

Pobiera lub ustawia OverrideMode wartość wyliczenia określającą, czy skojarzona sekcja konfiguracji może zostać zastąpiona przez podrzędne pliki konfiguracji.

OverrideModeDefault

Pobiera lub ustawia wartość określającą domyślne zachowanie przesłonięcia sekcji konfiguracji według podrzędnych plików konfiguracji.

OverrideModeEffective

Pobiera zachowanie przesłonięcia sekcji konfiguracji, która jest z kolei oparta na tym, czy podrzędne pliki konfiguracji mogą zablokować sekcję konfiguracji.

ProtectionProvider

Pobiera chronionego dostawcę konfiguracji dla skojarzonej sekcji konfiguracji.

RequirePermission

Pobiera wartość wskazującą, czy skojarzona sekcja konfiguracji wymaga uprawnień dostępu.

RestartOnExternalChanges

Pobiera lub ustawia wartość określającą, czy zmiana konfiguracji zewnętrznej uwzględnia plik wymaga ponownego uruchomienia aplikacji.

SectionName

Pobiera nazwę skojarzonej sekcji konfiguracji.

Type

Pobiera lub ustawia nazwę klasy sekcji.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ForceDeclaration()

Wymusza wyświetlenie skojarzonej sekcji konfiguracji w pliku konfiguracji.

ForceDeclaration(Boolean)

Wymusza wyświetlenie skojarzonej sekcji konfiguracji w pliku konfiguracji lub usunięcie istniejącej sekcji z pliku konfiguracji.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetParentSection()

Pobiera sekcję konfiguracji zawierającą sekcję konfiguracji skojarzona z tym obiektem.

GetRawXml()

Zwraca obiekt węzła XML reprezentujący skojarzony obiekt sekcji konfiguracji.

GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ProtectSection(String)

Oznacza sekcję konfiguracji ochrony.

RevertToParent()

Powoduje, że skojarzona sekcja konfiguracji dziedziczy wszystkie jej wartości z sekcji nadrzędnej.

SetRawXml(String)

Ustawia obiekt na reprezentację XML skojarzonej sekcji konfiguracji w pliku konfiguracji.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
UnprotectSection()

Usuwa szyfrowanie chronionej konfiguracji z skojarzonej sekcji konfiguracji.

Dotyczy

Zobacz też