ConfigurationSection.SetAllowDefinition 方法

为配置节设置 allowDefinition 属性。

语法

ConfigurationSection.SetAllowDefinition(AllowDefinition)  

ConfigurationSection.SetAllowDefinition(AllowDefinition);  

参数设置

名称	定义
AllowDefinition	一个 string 变量，用于指定要设置 allowDefinition 属性的值。 后文的“注解”部分列出了可能的属性。

返回值

此方法不返回值。

注解

allowDefinition 属性指定可在配置层次结构中为给定配置节设置值。 这些属性在 ApplicationHost.config 文件的 <configSections> 节中指定。

由于 SetAllowDefinition 是静态方法，应通过获取类对象来调用该方法，如下例所示。

' Correct syntax:  
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")  
oAnonAuth.SetAllowDefinition "MachineOnly"  

以下语法失败，因为它尝试在 Site 类的具体实例上调用 SetAllowDefinition。 对该方法的调用将导致“SWbemObjectEx: 找不到”错误。

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

下表列出了 allowDefinition 属性可能的值。

关键字	说明
Everywhere	可在层次结构中的任意位置设置该节。
MachineOnly	该节只能在 Machine.config 文件中设置。 注意：Machine.config 文件的默认位置为 %systemroot% Microsoft.NET\Framework\<version>\config\。
MachineToWebRoot	该节只能在 Machine.config 文件或根 Web.config 文件中设置。 注意：根 Web.config 文件的默认位置为 %systemroot% Microsoft.NET\Framework\<version>\config\。
AppHostOnly	该节只能在 ApplicationHost.config 文件中设置。
MachineToApplication	该节只能在全局级别设置。 对于 .NET Framework 节，全局级别为根 Web.config 或 Machine.config 文件；对于 IIS 节，则为 ApplicationHost.config 文件；对于应用程序，则为根应用程序的 Web.config 文件。

示例

以下示例设置匿名身份验证配置节的 allowDefinition 属性。

' Get the WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the AnonymousAuthenticationSection.  
Set oAnonAuth = oWebAdmin.Get( _  
    "AnonymousAuthenticationSection")  
  
' Set the AllowDefinition attribute.  
oAnonAuth.SetAllowDefinition "MachineToApplication"  
  

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上）
服务器	- IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上）
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

AnonymousAuthenticationSection 类
ConfigurationSection 类
ConfigurationSection.GetAllowDefinition 方法