SectionInformation Clase

Definición

Contiene metadatos sobre una sección concreta de la jerarquía de configuración.Contains metadata about an individual section within the configuration hierarchy. Esta clase no puede heredarse.This class cannot be inherited.

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 SectionInformation los metadatos asociados a un ConfigurationSection objeto.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
 

El ejemplo siguiente es un extracto del archivo de configuración que se usa en el ejemplo anterior.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>  

Comentarios

El SectionInformation objeto contiene los metadatos sobre una sección individual dentro de la jerarquía de configuración.The SectionInformation object contains the metadata about an individual section within the configuration hierarchy. Este objeto se puede utilizar para validar y cambiar las propiedades de una sección individual.This object can be used in order to validate and change the properties of an individual section.

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

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

AllowLocation

Obtiene o establece un valor que indica si la sección de configuración permite el atributo location.Gets or sets a value that indicates whether the configuration section allows the location attribute.

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.Gets or sets a value that indicates whether the associated configuration section can be overridden by lower-level configuration files.

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.Gets or sets the name of the include file in which the associated configuration section is defined, if such a file exists.

ConfigurationBuilder

Obtiene el objeto ConfigurationBuilder de esta sección de configuración.Gets the ConfigurationBuilder object for this configuration section.

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.Gets or sets a value that indicates whether the associated configuration section will be saved even if it has not been modified.

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

Obtiene un valor que indica si la sección de configuración debe declararse en el archivo de configuración.Gets a value that indicates whether the configuration section must be declared in the configuration file.

IsDeclared

Obtiene un valor que indica si la sección de configuración asociada se declara en el archivo de configuración.Gets a value that indicates whether the associated configuration section is declared in the configuration file.

IsLocked

Obtiene un valor que indica si la sección de configuración asociada está bloqueada.Gets a value that indicates whether the associated configuration section is locked.

IsProtected

Obtiene un valor que indica si la sección de configuración asociada está protegida.Gets a value that indicates whether the associated configuration section is protected.

Name

Obtiene el nombre de la sección de configuración asociada.Gets the name of the associated configuration section.

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

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

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

ProtectionProvider

Obtiene el proveedor de configuración protegida para la sección de configuración asociada.Gets the protected configuration provider for the associated configuration section.

RequirePermission

Obtiene un valor que indica si la sección de configuración asociada necesita permisos de acceso.Gets a value that indicates whether the associated configuration section requires access permissions.

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

SectionName

Obtiene el nombre de la sección de configuración asociada.Gets the name of the associated configuration section.

Type

Obtiene o establece el nombre de la clase de sección.Gets or sets the section class name.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
ForceDeclaration()

Fuerza que la sección de configuración asociada aparezca en el archivo de configuración.Forces the associated configuration section to appear in the configuration file.

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.Forces the associated configuration section to appear in the configuration file, or removes an existing section from the configuration file.

GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetParentSection()

Obtiene la sección de configuración que contiene la sección de configuración asociada a este objeto.Gets the configuration section that contains the configuration section associated with this object.

GetRawXml()

Devuelve un objeto de nodo XML que representa el objeto de sección de configuración asociado.Returns an XML node object that represents the associated configuration-section object.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ProtectSection(String)

Marca una sección de configuración para la protección.Marks a configuration section for protection.

RevertToParent()

Hace que la sección de configuración asociada herede todos sus valores de la sección primaria.Causes the associated configuration section to inherit all its values from the parent section.

SetRawXml(String)

Establece el objeto en una representación XML de la sección de configuración asociada del archivo de configuración.Sets the object to an XML representation of the associated configuration section within the configuration file.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
UnprotectSection()

Quita el cifrado de configuración protegida de la sección de configuración asociada.Removes the protected configuration encryption from the associated configuration section.

Se aplica a

Consulte también: