Compartir a través de

ConfigurationSection.GetAllowDefinition (método)

  • Artículo

Recupera el atributo allowDefinition de una sección de configuración.

Sintaxis

ConfigurationSection.GetAllowDefinition AllowDefinition  

ConfigurationSection.GetAllowDefinition(AllowDefinition);

Parámetros

Nombre Definición
AllowDefinition Variable string que recibe el atributo allowDefinition que devuelve el método GetAllowDefinition. Los valores de atributo posibles se enumeran más adelante en la sección Comentarios.

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

Los atributos allowDefinition especifican dónde se pueden establecer los valores de la jerarquía de configuración para una sección de configuración determinada. Estos atributos se especifican en la sección <configSections> del archivo ApplicationHost.config.

Dado que GetAllowDefinition es un método estático, debe llamarlo obteniendo un objeto de clase, como en el ejemplo siguiente.

' Correct syntax:  
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")  
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition

Se produce un error en la sintaxis siguiente porque intenta llamar a GetAllowDefinition en una instancia concreta de la clase Site. La llamada al método provocará un error de tipo "SWbemObjectEx: No encontrado".

' Incorrect syntax:  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "AnonymousAuthenticationSection", oAnonAuth  
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition

En la siguiente tabla se describen los posibles valores del atributo allowDefinition.

Palabra clave Descripción
Everywhere La sección se puede establecer en cualquier lugar de la jerarquía.
MachineOnly La sección solo se puede establecer en el archivo Machine.config. Nota: La ubicación predeterminada del archivo Machine.config es %systemroot% Microsoft.NET\Framework\<versión>\config\.
MachineToWebRoot La sección solo se puede establecer en el archivo Machine.config o en el archivo Web.config raíz. Nota: La ubicación predeterminada del archivo Web.config raíz es %systemroot% Microsoft.NET\Framework\<versión>\config\.
AppHostOnly La sección solo se puede establecer en el archivo ApplicationHost.config.
MachineToApplication La sección solo se puede establecer en el nivel global. En las secciones de .NET Framework, el nivel global es el archivo raíz Web.config o Machine.config; para las secciones de IIS, es el archivo ApplicationHost.config; y para las aplicaciones, es el archivo Web.config para la aplicación raíz.

Ejemplo

En el ejemplo siguiente se muestra el atributo allowDefinition de la sección de configuración de autenticación anónima.

' Get the WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the AnonymousAuthenticationSection.  
Set oAnonAuth = oWebAdmin.Get( _  
    "AnonymousAuthenticationSection")  
  
' Get the allowDefinition attribute.  
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition  
  
' Display the allowDefinition attribute.  
WScript.Echo _  
    "Anonymous Authentication Allow Definition: " & _  
        strAnonAuthAllowDefinition

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

Consulte también

AnonymousAuthenticationSection (clase)
ConfigurationSection (clase)