Метод ConfigurationSection.GetAllowDefinition

Статья
2023-07-19

Извлекает allowDefinition атрибут для раздела конфигурации.

Синтаксис

ConfigurationSection.GetAllowDefinition AllowDefinition

ConfigurationSection.GetAllowDefinition(AllowDefinition);

Параметры

Имя	Определение
`AllowDefinition`	Переменная `string` , получающая `allowDefinition` атрибут, возвращаемый методом `GetAllowDefinition` . Возможные значения атрибутов перечислены далее в разделе Примечания.

Возвращаемое значение

Этот метод не возвращает значение.

allowDefinition атрибуты указывают, где в иерархии конфигурации могут быть заданы значения для данного раздела конфигурации. Эти атрибуты указываются в <configSections> разделе файла ApplicationHost.config.

Так как GetAllowDefinition является статическим методом, его следует вызвать, получив объект класса, как показано в следующем примере.

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

Следующий синтаксис завершается ошибкой, так как он пытается вызвать GetAllowDefinition конкретный Site экземпляр класса . Вызов метода вызовет ошибку "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

См. также:

Класс AnonymousAuthenticationSection
Класс ConfigurationSection

Поделиться через