SectionInformation SectionInformation SectionInformation SectionInformation Class

Definizione

Contiene metadati su una singola sezione contenuta nella gerarchia di configurazione.Contains metadata about an individual section within the configuration hierarchy. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class SectionInformation sealed
public sealed class SectionInformation
type SectionInformation = class
Public NotInheritable Class SectionInformation
Ereditarietà
SectionInformationSectionInformationSectionInformationSectionInformation

Esempi

Nell'esempio seguente viene illustrato come ottenere il SectionInformation metadati che sono associato un ConfigurationSection oggetto.The following example shows how to get the SectionInformation metadata that is associated with a ConfigurationSection object.

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 che viene usato nell'esempio precedente.The following example is an excerpt of the configuration file that is used by the previous example.

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

Il SectionInformation oggetto contiene i metadati su una singola sezione all'interno della gerarchia di configurazione.The SectionInformation object contains the metadata about an individual section within the configuration hierarchy. Questo oggetto può essere utilizzato per convalidare e modificare le proprietà di una singola sezione.This object can be used in order to validate and change the properties of an individual section.

Proprietà

AllowDefinition AllowDefinition AllowDefinition 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.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be defined.

AllowExeDefinition AllowExeDefinition AllowExeDefinition 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.Gets or sets a value that indicates where in the configuration file hierarchy the associated configuration section can be declared.

AllowLocation AllowLocation AllowLocation AllowLocation

Ottiene o imposta un valore che indica se la sezione di configurazione accetta l'attributo location.Gets or sets a value that indicates whether the configuration section allows the location attribute.

AllowOverride AllowOverride AllowOverride AllowOverride

Ottiene o imposta un valore che indica se file di configurazione di livello inferiore possono eseguire l'override della sezione di configurazione associata.Gets or sets a value that indicates whether the associated configuration section can be overridden by lower-level configuration files.

ConfigSource ConfigSource ConfigSource ConfigSource

Ottiene o imposta il nome dell'eventuale file di inclusione in cui è definita la sezione di configurazione associata.Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

ConfigurationBuilder ConfigurationBuilder ConfigurationBuilder ConfigurationBuilder

Ottiene l'oggetto ConfigurationBuilder per questa sezione di configurazione.Gets the ConfigurationBuilder object for this configuration section.

ForceSave ForceSave ForceSave ForceSave

Ottiene o imposta un valore che indica se la sezione di configurazione associata verrà salvata anche se non è stata modificata.Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

InheritInChildApplications InheritInChildApplications InheritInChildApplications 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.Gets or sets a value that indicates whether the settings that are specified in the associated configuration section are inherited by applications that reside in a subdirectory of the relevant application.

IsDeclarationRequired IsDeclarationRequired IsDeclarationRequired IsDeclarationRequired

Ottiene un valore che indica se la sezione di configurazione deve essere dichiarata nel file di configurazione.Gets a value that indicates whether the configuration section must be declared in the configuration file.

IsDeclared IsDeclared IsDeclared IsDeclared

Ottiene un valore che indica se la sezione di configurazione associata viene dichiarata nel file di configurazione.Gets a value that indicates whether the associated configuration section is declared in the configuration file.

IsLocked IsLocked IsLocked IsLocked

Ottiene un valore che indica se la sezione di configurazione associata è bloccata.Gets a value that indicates whether the associated configuration section is locked.

IsProtected IsProtected IsProtected IsProtected

Ottiene un valore che indica se la sezione di configurazione associata è protetta.Gets a value that indicates whether the associated configuration section is protected.

Name Name Name Name

Ottiene il nome della sezione di configurazione associata.Gets the name of the associated configuration section.

OverrideMode OverrideMode OverrideMode 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.Gets or sets the OverrideMode enumeration value that specifies whether the associated configuration section can be overridden by child configuration files.

OverrideModeDefault OverrideModeDefault OverrideModeDefault 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.Gets or sets a value that specifies the default override behavior of a configuration section by child configuration files.

OverrideModeEffective OverrideModeEffective OverrideModeEffective 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.Gets the override behavior of a configuration section that is in turn based on whether child configuration files can lock the configuration section.

ProtectionProvider ProtectionProvider ProtectionProvider ProtectionProvider

Ottiene il provider di configurazione protetta per la sezione di configurazione associata.Gets the protected configuration provider for the associated configuration section.

RequirePermission RequirePermission RequirePermission RequirePermission

Ottiene un valore che indica se per la sezione di configurazione associata sono necessarie autorizzazioni di accesso.Gets a value that indicates whether the associated configuration section requires access permissions.

RestartOnExternalChanges RestartOnExternalChanges RestartOnExternalChanges 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.Gets or sets a value that specifies whether a change in an external configuration include file requires an application restart.

SectionName SectionName SectionName SectionName

Ottiene il nome della sezione di configurazione associata.Gets the name of the associated configuration section.

Type Type Type Type

Ottiene o imposta il nome della classe della sezione.Gets or sets the section class name.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ForceDeclaration() ForceDeclaration() ForceDeclaration() ForceDeclaration()

Impone l'inserimento della sezione di configurazione associata nel file di configurazione.Forces the associated configuration section to appear in the configuration file.

ForceDeclaration(Boolean) ForceDeclaration(Boolean) ForceDeclaration(Boolean) ForceDeclaration(Boolean)

Impone l'inserimento della sezione di configurazione associata nel file di configurazione o rimuove dal file di configurazione una sezione esistente.Forces the associated configuration section to appear in the configuration file, or removes an existing section from the configuration file.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetParentSection() GetParentSection() GetParentSection() GetParentSection()

Ottiene la sezione di configurazione che contiene la sezione di configurazione associata a questo oggetto.Gets the configuration section that contains the configuration section associated with this object.

GetRawXml() GetRawXml() GetRawXml() GetRawXml()

Restituisce un oggetto nodo XML che rappresenta l'oggetto sezione di configurazione associato.Returns an XML node object that represents the associated configuration-section object.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ProtectSection(String) ProtectSection(String) ProtectSection(String) ProtectSection(String)

Contrassegna una sezione di configurazione per la protezione.Marks a configuration section for protection.

RevertToParent() RevertToParent() RevertToParent() RevertToParent()

Fa in modo che la sezione di configurazione associata erediti tutti i valori dalla sezione padre.Causes the associated configuration section to inherit all its values from the parent section.

SetRawXml(String) SetRawXml(String) SetRawXml(String) SetRawXml(String)

Imposta l'oggetto su una rappresentazione XML della sezione di configurazione associata presente nel file di configurazione.Sets the object to an XML representation of the associated configuration section within the configuration file.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)
UnprotectSection() UnprotectSection() UnprotectSection() UnprotectSection()

Rimuove la crittografia della configurazione protetta dalla sezione di configurazione associata.Removes the protected configuration encryption from the associated configuration section.

Si applica a

Vedi anche