SectionInformation Clase

Definición

Espacio de nombres:

System.Configuration

Ensamblado:

System.Configuration.ConfigurationManager.dll

Ensamblado:

System.Configuration.dll

Contiene metadatos sobre una sección concreta de la jerarquía de configuración. Esta clase no puede heredarse.

public ref class SectionInformation sealed

public sealed class SectionInformation

type SectionInformation = class

Public NotInheritable Class SectionInformation

Herencia

Object

SectionInformation

Ejemplos

En el ejemplo siguiente se muestra cómo obtener los SectionInformation metadatos asociados a un ConfigurationSection objeto .

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

El ejemplo siguiente es un extracto del archivo de configuración que usa el ejemplo anterior.

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

Comentarios

El SectionInformation objeto contiene los metadatos sobre una sección individual dentro de la jerarquía de configuración. Este objeto se puede usar para validar y cambiar las propiedades de una sección individual.

Propiedades

AllowDefinition	Obtiene o establece un valor que indica el lugar de la jerarquía del archivo de configuración en el que se puede definir la sección de configuración asociada.
AllowExeDefinition	Obtiene o establece un valor que indica el lugar de la jerarquía del archivo de configuración en el que se puede declarar la sección de configuración asociada.
AllowLocation	Obtiene o establece un valor que indica si la sección de configuración permite el atributo location.
AllowOverride	Obtiene o establece un valor que indica si los archivos de configuración con un nivel inferior pueden invalidar la sección de configuración asociada.
ConfigSource	Obtiene o establece el nombre del archivo de inclusión en el que se define la sección de configuración asociada, si existe tal archivo.
ConfigurationBuilder	Obtiene el objeto ConfigurationBuilder de esta sección de configuración.
ForceSave	Obtiene o establece un valor que indica si se va a guardar la sección de configuración asociada aunque no se haya modificado.
InheritInChildApplications	Obtiene o establece un valor que indica si los valores especificados en la sección de configuración asociada los heredan las aplicaciones que residen en un subdirectorio de la aplicación correspondiente.
IsDeclarationRequired	Obtiene un valor que indica si la sección de configuración debe declararse en el archivo de configuración.
IsDeclared	Obtiene un valor que indica si la sección de configuración asociada se declara en el archivo de configuración.
IsLocked	Obtiene un valor que indica si la sección de configuración asociada está bloqueada.
IsProtected	Obtiene un valor que indica si la sección de configuración asociada está protegida.
Name	Obtiene el nombre de la sección de configuración asociada.
OverrideMode	Obtiene o establece el valor de la enumeración OverrideMode que especifica si los archivos de configuración secundarios pueden invalidar la sección de configuración asociada.
OverrideModeDefault	Obtiene o establece un valor que especifica el comportamiento de invalidación predeterminado de una sección de configuración por parte de los archivos de configuración secundarios.
OverrideModeEffective	Obtiene el comportamiento de invalidación de una sección de configuración que, a su vez, depende de si los archivos de configuración secundarios pueden bloquear la sección de configuración.
ProtectionProvider	Obtiene el proveedor de configuración protegida para la sección de configuración asociada.
RequirePermission	Obtiene un valor que indica si la sección de configuración asociada necesita permisos de acceso.
RestartOnExternalChanges	Obtiene o establece un valor que especifica si un cambio en un archivo de inclusión de configuración externo necesita el reinicio de una aplicación.
SectionName	Obtiene el nombre de la sección de configuración asociada.
Type	Obtiene o establece el nombre de la clase de sección.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ForceDeclaration()	Fuerza que la sección de configuración asociada aparezca en el archivo de configuración.
ForceDeclaration(Boolean)	Fuerza que la sección de configuración asociada aparezca en el archivo de configuración o quita una sección existente del archivo de configuración.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetParentSection()	Obtiene la sección de configuración que contiene la sección de configuración asociada a este objeto.
GetRawXml()	Devuelve un objeto de nodo XML que representa el objeto de sección de configuración asociado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ProtectSection(String)	Marca una sección de configuración para la protección.
RevertToParent()	Hace que la sección de configuración asociada herede todos sus valores de la sección primaria.
SetRawXml(String)	Establece el objeto en una representación XML de la sección de configuración asociada del archivo de configuración.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
UnprotectSection()	Quita el cifrado de configuración protegida de la sección de configuración asociada.

Consulte también

• ConfigurationSection