ConfigurationSection.GetAllowDefinition 方法
检索配置节的 allowDefinition 属性。
语法
ConfigurationSection.GetAllowDefinition AllowDefinition
ConfigurationSection.GetAllowDefinition(AllowDefinition);
参数设置
| 名称 | 定义 |
|---|---|
AllowDefinition |
一个 string 变量，用于接收 GetAllowDefinition 方法返回的 allowDefinition 属性。 后文的“注解”部分列出了可能的属性。 |
返回值
此方法不返回值。
注解
allowDefinition 属性指定可在配置层次结构中为给定配置节设置值。 这些属性在 ApplicationHost.config 文件的 <configSections> 节中指定。
由于 GetAllowDefinition 是静态方法，应通过获取类对象来调用该方法，如下例所示。
' Correct syntax:
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition
以下语法失败，因为它尝试在 Site 类的具体实例上调用 GetAllowDefinition。 对该方法的调用将导致“SWbemObjectEx: 找不到”错误。
' Incorrect syntax:
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "AnonymousAuthenticationSection", oAnonAuth
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition
下表列出了 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")
' Get the allowDefinition attribute.
oAnonAuth.GetAllowDefinition strAnonAuthAllowDefinition
' Display the allowDefinition attribute.
WScript.Echo _
"Anonymous Authentication Allow Definition: " & _
strAnonAuthAllowDefinition
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - 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 |