SectionInformation Classe

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

Contiene metadati su una singola sezione contenuta nella gerarchia di configurazione. La classe non può essere ereditata.

public ref class SectionInformation sealed

public sealed class SectionInformation

type SectionInformation = class

Public NotInheritable Class SectionInformation

Ereditarietà

Object

SectionInformation

Esempio

Nell'esempio seguente viene illustrato come ottenere i SectionInformation metadati associati a un ConfigurationSection oggetto.

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

L'esempio seguente è un estratto del file di configurazione usato dall'esempio precedente.

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

Commenti

L'oggetto SectionInformation contiene i metadati relativi a una singola sezione all'interno della gerarchia di configurazione. Questo oggetto può essere usato per convalidare e modificare le proprietà di una singola sezione.

Proprietà

AllowDefinition	Ottiene o imposta un valore che indica la posizione nella gerarchia di file di configurazione in cui può essere definita la sezione di configurazione associata.
AllowExeDefinition	Ottiene o imposta un valore che indica la posizione nella gerarchia di file di configurazione in cui può essere dichiarata la sezione di configurazione associata.
AllowLocation	Ottiene o imposta un valore che indica se la sezione di configurazione accetta l'attributo location.
AllowOverride	Ottiene o imposta un valore che indica se file di configurazione di livello inferiore possono eseguire l'override della sezione di configurazione associata.
ConfigSource	Ottiene o imposta il nome dell'eventuale file di inclusione in cui è definita la sezione di configurazione associata.
ForceSave	Ottiene o imposta un valore che indica se la sezione di configurazione associata verrà salvata anche se non è stata modificata.
InheritInChildApplications	Ottiene o imposta un valore che indica se le impostazioni specificate nella sezione di configurazione associata vengono ereditate da applicazioni che risiedono in una sottodirectory dell'applicazione pertinente.
IsDeclarationRequired	Ottiene un valore che indica se la sezione di configurazione deve essere dichiarata nel file di configurazione.
IsDeclared	Ottiene un valore che indica se la sezione di configurazione associata viene dichiarata nel file di configurazione.
IsLocked	Ottiene un valore che indica se la sezione di configurazione associata è bloccata.
IsProtected	Ottiene un valore che indica se la sezione di configurazione associata è protetta.
Name	Ottiene il nome della sezione di configurazione associata.
OverrideMode	Ottiene o imposta il valore di enumerazione di OverrideMode che specifica se i file di configurazione figlio possono eseguire l'override della sezione di configurazione associata.
OverrideModeDefault	Ottiene o imposta un valore che specifica il comportamento di override predefinito di una sezione di configurazione da parte dei file di configurazione figlio.
OverrideModeEffective	Ottiene il comportamento di override di una sezione di configurazione, che a sua volta si basa sulla capacità da parte dei file di configurazione figlio di bloccare o meno la sezione di configurazione.
ProtectionProvider	Ottiene il provider di configurazione protetta per la sezione di configurazione associata.
RequirePermission	Ottiene un valore che indica se per la sezione di configurazione associata sono necessarie autorizzazioni di accesso.
RestartOnExternalChanges	Ottiene o imposta un valore che specifica se in caso di modifica di un file di inclusione di configurazione esterno è necessario riavviare l'applicazione.
SectionName	Ottiene il nome della sezione di configurazione associata.
Type	Ottiene o imposta il nome della classe della sezione.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ForceDeclaration()	Impone l'inserimento della sezione di configurazione associata nel file di configurazione.
ForceDeclaration(Boolean)	Impone l'inserimento della sezione di configurazione associata nel file di configurazione o rimuove dal file di configurazione una sezione esistente.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetParentSection()	Ottiene la sezione di configurazione che contiene la sezione di configurazione associata a questo oggetto.
GetRawXml()	Restituisce un oggetto nodo XML che rappresenta l'oggetto sezione di configurazione associato.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ProtectSection(String)	Contrassegna una sezione di configurazione per la protezione.
RevertToParent()	Fa in modo che la sezione di configurazione associata erediti tutti i valori dalla sezione padre.
SetRawXml(String)	Imposta l'oggetto su una rappresentazione XML della sezione di configurazione associata presente nel file di configurazione.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
UnprotectSection()	Rimuove la crittografia della configurazione protetta dalla sezione della configurazione associata.

Vedi anche

• ConfigurationSection