SectionInformation Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Contiene metadatos sobre una sección concreta de la jerarquía de configuración. Esta clase no puede heredarse.
public ref class SectionInformation sealedpublic sealed class SectionInformationtype SectionInformation = classPublic 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 |
| 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. |
