SectionInformation Classe

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

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

Origine:

SectionInformation.cs

Contiene i metadati relativi a una singola sezione all'interno della 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à

Nome	Descrizione
AllowDefinition	Ottiene o imposta un valore che indica dove è possibile definire la sezione di configurazione associata nella gerarchia dei file di configurazione.
AllowExeDefinition	Ottiene o imposta un valore che indica dove è possibile dichiarare nella gerarchia dei file di configurazione la sezione di configurazione associata.
AllowLocation	Ottiene o imposta un valore che indica se la sezione di configurazione consente l'attributo location .
AllowOverride	Ottiene o imposta un valore che indica se la sezione di configurazione associata può essere sostituita da file di configurazione di livello inferiore.
ConfigSource	Ottiene o imposta il nome del file di inclusione in cui è definita la sezione di configurazione associata, se tale file esiste.
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 dalle 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 OverrideMode valore di enumerazione che specifica se la sezione di configurazione associata può essere sostituita dai file di configurazione figlio.
OverrideModeDefault	Ottiene o imposta un valore che specifica il comportamento di override predefinito di una sezione di configurazione in base ai file di configurazione figlio.
OverrideModeEffective	Ottiene il comportamento di override di una sezione di configurazione a sua volta basata sul fatto che i file di configurazione figlio possano bloccare la sezione di configurazione.
ProtectionProvider	Ottiene il provider di configurazione protetto per la sezione di configurazione associata.
RequirePermission	Ottiene un valore che indica se la sezione di configurazione associata richiede autorizzazioni di accesso.
RestartOnExternalChanges	Ottiene o imposta un valore che specifica se una modifica in un file di inclusione della configurazione esterna richiede un riavvio dell'applicazione.
SectionName	Ottiene il nome della sezione di configurazione associata.
Type	Ottiene o imposta il nome della classe di sezione.

Metodi

Nome	Descrizione
ForceDeclaration()	Forza la visualizzazione della sezione di configurazione associata nel file di configurazione.
ForceDeclaration(Boolean)	Forza la visualizzazione della sezione di configurazione associata nel file di configurazione o la rimozione di una sezione esistente dal file di configurazione.
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 della sezione di configurazione associato.
ProtectSection(String)	Contrassegna una sezione di configurazione per la protezione.
RevertToParent()	Fa in modo che la sezione di configurazione associata erediti tutti i relativi valori dalla sezione padre.
SetRawXml(String)	Imposta l'oggetto su una rappresentazione XML della sezione di configurazione associata all'interno del file di configurazione.
UnprotectSection()	Rimuove la crittografia della configurazione protetta dalla sezione di configurazione associata.

Vedi anche

• ConfigurationSection