SectionInformation Klasa

Definicja

Przestrzeń nazw:

System.Configuration

Zestaw:

System.Configuration.ConfigurationManager.dll

Pakiet:

System.Configuration.ConfigurationManager v8.0.0

Źródło:

SectionInformation.cs

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

Object

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

Zobacz też

• ConfigurationSection