SectionInformation Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

SectionInformation.cs

Contient les métadonnées concernant une section individuelle dans la hiérarchie de configuration. Cette classe ne peut pas être héritée.

public ref class SectionInformation sealed

public sealed class SectionInformation

type SectionInformation = class

Public NotInheritable Class SectionInformation

Héritage

Object

SectionInformation

Exemples

L’exemple suivant montre comment obtenir les SectionInformation métadonnées associées à un ConfigurationSection objet .

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’exemple suivant est un extrait du fichier de configuration utilisé par l’exemple précédent.

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

Remarques

L’objet SectionInformation contient les métadonnées relatives à une section individuelle dans la hiérarchie de configuration. Cet objet peut être utilisé pour valider et modifier les propriétés d’une section individuelle.

Propriétés

AllowDefinition	Obtient ou définit une valeur qui indique à quel niveau de la hiérarchie des fichiers de configuration la section de configuration associée peut être définie.
AllowExeDefinition	Obtient ou définit une valeur qui indique à quel niveau de la hiérarchie des fichiers de configuration la section de configuration associée peut être déclarée.
AllowLocation	Obtient ou définit une valeur qui indique si la section de configuration autorise l'attribut location.
AllowOverride	Obtient ou définit une valeur qui indique si la section de configuration associée peut être substituée par des fichiers de configuration de niveau inférieur.
ConfigSource	Obtient ou définit le nom du fichier Include dans lequel la section de configuration associée est définie, si ce fichier existe.
ForceSave	Obtient ou définit une valeur qui indique si la section de configuration associée est enregistrée même si elle n'est pas modifiée.
InheritInChildApplications	Obtient ou définit une valeur qui indique si les paramètres spécifiés dans la section de configuration associée sont hérités par des applications qui résident dans un sous-répertoire de l'application correspondante.
IsDeclarationRequired	Obtient une valeur qui indique si la section de configuration doit être déclarée dans le fichier de configuration.
IsDeclared	Obtient une valeur qui indique si la section de configuration associée est déclarée dans le fichier de configuration.
IsLocked	Obtient une valeur qui indique si la section de configuration associée est verrouillée.
IsProtected	Obtient une valeur qui indique si la section de configuration associée est protégée.
Name	Obtient le nom de la section de configuration associée.
OverrideMode	Obtient ou définit la valeur d'énumération OverrideMode qui spécifie si la section de configuration associée peut être substituée par les fichiers de configuration enfants.
OverrideModeDefault	Obtient ou définit une valeur qui spécifie le comportement de substitution par défaut d'une section de configuration par les fichiers de configuration enfants.
OverrideModeEffective	Obtient le comportement de substitution d'une section de configuration qui est à son tour basée sur la capacité des fichiers de configuration enfants à verrouiller la section de configuration.
ProtectionProvider	Obtient le fournisseur de configuration protégée pour la section de configuration associée.
RequirePermission	Obtient une valeur qui indique si la section de configuration associée requiert des autorisations d'accès.
RestartOnExternalChanges	Obtient ou définit une valeur qui spécifie si la modification d'un fichier Include de configuration externe requiert un redémarrage de l'application.
SectionName	Obtient le nom de la section de configuration associée.
Type	Obtient ou définit le nom de la classe de la section.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ForceDeclaration()	Force l'affichage de la section de configuration associée dans le fichier de configuration.
ForceDeclaration(Boolean)	Force l'affichage de la section de configuration associée dans le fichier de configuration ou supprime une section existante du fichier de configuration.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetParentSection()	Obtient la section de configuration qui contient la section de configuration associée à cet objet.
GetRawXml()	Retourne un objet nœud XML qui représente l'objet de la section de configuration associée.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ProtectSection(String)	Marque une section de configuration pour la protection.
RevertToParent()	Fait que toutes les valeurs de la section de configuration associée sont héritées de la section parente.
SetRawXml(String)	Affecte à l'objet une valeur de représentation XML de la section de configuration associée dans le fichier de configuration.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UnprotectSection()	Supprime le chiffrement de configuration protégée de la section de configuration associée.

Voir aussi

• ConfigurationSection