SectionInformation Class
Especifica la configuración de modo de invalidación y bloqueo de control para una sección de configuración.
Sintaxis
class SectionInformation : EmbeddedObject
Métodos
Esta clase no contiene métodos.
Propiedades
La siguiente tabla muestra las propiedades expuestas por la clase SectionInformation.
| Nombre | Descripción |
|---|---|
EffectiveOverrideMode |
Valor de solo lectura string que especifica si la sección de configuración actual puede invalidar eficazmente sus valores heredados. Los valores posibles se enumeran más adelante en la sección Comentarios.Para determinar el valor de EffectiveOverrideMode, IIS recorre la jerarquía de herencia de las secciones de configuración de la sección actual. Examina sucesivamente la propiedad OverrideMode de cada sección primaria hasta que alcanza el atributo overrideModeDefault en la definición de esquema de sección. IIS calcula el EffectiveOverrideMode mediante la combinación lógica de los valores que encuentra y considera su clasificación jerárquica. Nota: overrideModeDefault es un atributo opcional que contiene el estado de bloqueo predeterminado de una sección de configuración. El atributo overrideModeDefault de cada sección de configuración se encuentra en la definición de sección correspondiente en <configSections> en el archivo ApplicationHost.config. Si overrideModeDefault falta, su valor es "Permitir". Si se especifica "Permitir", los archivos Web.config de nivel inferior pueden invalidar la configuración de la sección; si se especifica "Denegar", no pueden hacerlo. El valor predeterminado overrideModeDefault para la mayoría de las secciones del servidor web de IIS es "Denegar". El valor predeterminado para la mayoría de las secciones de ASP.NET y .NET Framework es "Permitir", ya que estas secciones contienen la configuración de nivel de aplicación. El atributo overrideModeDefault no tiene ninguna propiedad correspondiente en WMI. Si tiene los permisos adecuados, puede editar el archivo ApplicationHost.config directamente o acceder a él mediante programación a través del análisis XML o las API de acceso a archivos. |
IsLocked |
Un valor de tipo boolean de solo lectura. true si no se puede modificar la sección de configuración actual y sus elementos secundarios; de lo contrario, false. |
LockItem |
Valor boolean de lectura y escritura. true si la sección de configuración actual y sus elementos secundarios están bloqueados; de lo contrario, false. El valor predeterminado es false. Nota: Aunque el valor predeterminado es false, esta propiedad devolverá null cuando se lea inicialmente. Si establece explícitamente este valor inicial en false, la propiedad seguirá devolviendo null. Sin embargo, si establece el valor inicial en true, la propiedad devolverá true; si después establece el valor en false, la propiedad devolverá false explícitamente. Este comportamiento se debe a una limitación en el proveedor WMI. |
OverrideMode |
Valor de lectura y escritura string que especifica si los archivos de configuración de nivel inferior pueden invalidar los valores de la sección de configuración actual. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Subclases
Esta clase no contiene subclases.
Comentarios
Las instancias de esta clase están contenidas en la propiedad SectionInformation de la clase ConfigurationSection. Todas las clases de sección de configuración heredan la clase SectionInformation como una de sus propiedades.
En la siguiente tabla se describen los posibles valores de la propiedad EffectiveOverrideMode.
| Palabra clave | Descripción |
|---|---|
Allow |
Los archivos de configuración de nivel inferior pueden invalidar los valores de la sección de configuración actual. |
Deny |
Los archivos de configuración de nivel inferior no pueden invalidar los valores de la sección de configuración actual. |
En la siguiente tabla se describen los posibles valores de la propiedad OverrideMode. El valor predeterminado es "Heredar".
| Palabra clave | Descripción |
|---|---|
Inherit |
Los archivos de configuración de nivel inferior pueden invalidar o no invalidar la configuración de la sección de configuración actual, en función de la combinación los valores OverrideMode que hereden. |
Allow |
Los archivos de configuración de nivel inferior pueden invalidar los valores de la sección de configuración actual. |
Deny |
Los archivos de configuración de nivel inferior no pueden invalidar los valores de la sección de configuración actual. |
Nota:
La propiedad EffectiveOverrideMode es útil para determinar cuál es el modo de invalidación efectivo para una sección de configuración cuando la propiedad OverrideMode se establece en "Heredar".
Ejemplo
En el ejemplo siguiente se recuperan las propiedades SectionInformation de todas las secciones de configuración.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Retrieve configuration sections.
Set oConfigSections = oWebAdmin.ExecQuery( _
"SELECT * FROM ConfigurationSection")
' Loop through the configuration sections.
For Each oConfigSection In oConfigSections
iCounter = iCounter + 1
' Display the name of each configuration section and its location.
WScript.Echo "[" & iCounter & "] " & oConfigSection.Path_.Class
WScript.Echo "Location: " & oConfigSection.Location
' Display the SectionInformation property values.
Set oConfigSectionInfo = oConfigSection.SectionInformation
WScript.Echo "Effective Override Mode: " & _
oConfigSectionInfo.EffectiveOverrideMode
WScript.Echo "Is Locked: " & oConfigSectionInfo.IsLocked
WScript.Echo "Is Present: " & oConfigSectionInfo.IsPresent
WScript.Echo "Lock Item: " & oConfigSectionInfo.LockItem
WScript.Echo "Override Mode: " & oConfigSectionInfo.OverrideMode
WScript.Echo "------------------------------------------"
Next
Jerarquía de herencia
SectionInformation
Requisitos
| Tipo | Descripción |
|---|---|
| Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
| Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
| Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Archivo MOF | WebAdministration.mof |