SectionInformation Clase

Definición

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

Se aplica a

Consulte también