SectionInformation Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Configuration
Assembly:
System.Configuration.ConfigurationManager.dll
Assembly:
System.Configuration.dll
Pacchetto:
System.Configuration.ConfigurationManager v6.0.0
Pacchetto:
System.Configuration.ConfigurationManager v7.0.0
Pacchetto:
System.Configuration.ConfigurationManager v8.0.0
Pacchetto:
System.Configuration.ConfigurationManager v9.0.0-preview.2.24128.5
Source:
SectionInformation.cs
Source:
SectionInformation.cs
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.
ConfigurationBuilder

Ottiene l'oggetto ConfigurationBuilder per questa sezione di configurazione.
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.

Si applica a

Vedi anche