Класс HandlerAction

Статья
07/19/2023

Предоставляет параметры конфигурации для обработчиков.

Синтаксис

class HandlerAction : CollectionElement

Методы

Этот класс не содержит методов.

Свойства

В следующей таблице перечислены свойства, предоставляемые классом HandlerAction .

Имя	Описание
`AllowPathInfo`	Значение для чтения и записи `boolean` . `true` Значение , если обработчик будет обрабатывать полные сведения о пути в универсальном коде ресурса (URI); в противном случае — `false`. Значение по умолчанию — `false`. Например, при `true`значении это свойство позволяет обработчику обрабатывать полный путь, например "/vdir/myisapi.dll/zip"; при `false`значении это свойство разрешает только частичный путь "/zip".
`Modules`	Значение для чтения и записи `string` , указывающее модуль, которому требуется сопоставить файл или расширение. Значение по умолчанию — `null`.
`Name`	Обязательное уникальное значение для чтения и записи `string` , указывающее уникальное имя для сопоставления обработчика. Единственное свойство ключа.
`Path`	Значение для чтения и записи `string` , указывающее расширение файла или имя файла с расширением типа файла для обработки. Значение по умолчанию — `null`.
`PreCondition`	Значение для чтения и записи `string` , при необходимости указывающее условия, при которых может выполняться обработчик. Возможные значения перечислены далее в разделе Примечания.
`RequireAccess`	Перечисление для чтения и записи `sint32` , указывающее требования к доступу к обработчику. Возможные значения перечислены далее в разделе Примечания.
`ResourceType`	Перечисление для чтения и записи `sint32` , указывающее тип сопоставления для обработчика. Возможные значения перечислены далее в разделе Примечания.
`ResponseBufferLimit`	Значение для чтения и записи `uint32` , которое задает максимальный размер (в байтах) буфера ответов для обработчика запросов. Если буферизация ответов включена в свойстве класса PagesSection, `ResponseBufferLimit` свойство управляет максимальным числом байтов, которое asp-страница может записать в `Buffer` буфер ответа до того, как произойдет очистка. Значение по умолчанию — 4194304 байт.
`ScriptProcessor`	Значение для чтения и записи `string` , указывающее полный путь к расширению ISAPI .dll файлу или файлу .exe CGI, который обрабатывает запрос, если это необходимо. Если указать это свойство, необходимо указать в свойстве `Modules` "ISAPIModule" или "CGIModule". Значение по умолчанию — `null`.
`Type`	Значение для чтения и записи `string` , указывающее путь к пространству имен управляемого обработчика. Указанный тип должен быть допустимым управляемым типом, который находится в глобальном кэше сборок, каталоге Bin приложения или каталоге app_code. Значение по умолчанию — `null`.
`Verb`	Значение для чтения и записи `string` , указывающее разделенный запятыми список глаголов. Используйте это свойство, если требуется, чтобы сопоставление применялось к определенным типам запросов. Значение по умолчанию — `null`.

используются подклассы ;

Этот класс не содержит подклассов.

Оценка предусловия является логическим AND из компонентов. Поскольку любое неизвестное предусловие имеет falseзначение , наличие неизвестного предусловия приведет к тому, что неизвестное предусловие будет проигнорировано.

Значение	Описание
appPoolName=pool1;pool2	Обработчик будет использоваться для любого пула приложений с именем в списке, разделенном точкой с запятой.
appPoolName!=pool1;pool2	Обработчик не будет использоваться для пула приложений с именем в списке, разделенном точками с запятой.
битность32	Запись обработчика применяется только к 32-разрядным рабочим процессам. Для 64-разрядных компьютеров это значение следует использовать, чтобы указать, какие пулы приложений работают в 32-разрядном режиме.
bitness64	Обработчик применяется только к 64-разрядным рабочим процессам. Для 64-разрядных компьютеров это значение следует использовать, чтобы указать, какие пулы приложений работают в 64-разрядном режиме.
integratedMode	Обработчик будет использоваться только для пулов приложений в интегрированном режиме.
ISAPIMode	Обработчик будет использоваться только для пулов приложений в режиме ISAPI.
runtimeVersion	Обработчик будет использоваться только для пулов приложений, которые загружают определенную версию среды CLR. Чтобы включить это предварительное условие, добавьте строку в формате vMajorVersion. MinorVersion к строке runtimeVersion (например, runtimeVersionv2.0).

В следующей таблице перечислены возможные RequireAccess значения для свойства . Значение по умолчанию — 3 (Script).

Примечание

Параметры в свойстве AccessPolicy класса HandlersSection определяют, какие права разрешены и, следовательно, какие обработчики могут выполняться.

Значение	Ключевое слово	Описание
0	`None`	Обработчик не имеет требований к доступу.
1	`Read`	Обработчику требуется разрешение на чтение.
2	`Write`	Обработчику требуется разрешение на запись.
3	`Script`	Обработчику требуются права скрипта.
4	`Execute`	Обработчику требуются права исполняемого файла.

В следующей таблице перечислены возможные ResourceType значения для свойства . Значение по умолчанию — 3 (Unspecified).

Примечание

Это свойство помечено как Тип пути в диспетчере IIS.

Значение	Ключевое слово	Описание
0	`File`	Сопоставление предназначено для файла. Если входящий запрос не сопоставляется с физическим файлом на диске, запрос не передается обработчику.
1	`Directory`	Сопоставление предназначено для каталога. Если входящий запрос не сопоставляется с физической папкой на диске, запрос не передается обработчику.
2	`Either`	Сопоставление предназначено для файла или каталога. Если входящий запрос не сопоставляется с физическим файлом или папкой на диске, запрос не передается обработчику.
3	`Unspecified`	Тип сопоставления не указан. Запрос передается обработчику независимо от того, сопоставляется ли запрос с физическим файлом или папкой на диске. Используйте этот параметр, если вы сопоставляете обработчик с именем файла (например, MyHandler.axd), который, как вы знаете, не существует на диске.

Пример

В следующем примере в раздел добавляются <handlers> три различные категории обработчиков: обработчик сопоставления устаревших скриптов, два собственных обработчика модуля и управляемый обработчик.

Примечание

Добавление или удаление элемента конфигурации изменяет базовый раздел конфигурации, но не объектную переменную в скрипте, который представляет раздел конфигурации. Чтобы изменение отображалось в скриптах, необходимо вызвать метод WMI Refresh_ для переменной объекта после внесения изменения. Это приведет к обновлению объектной переменной последних данных из хранилища конфигураций.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the <handlers> section.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
oSite.GetSection "HandlersSection", oHandlersSection  
  
' Display the old list of handlers.  
WScript.Echo "---[Old Handler List]---"  
Call DisplayHandlers  
  
' Create a legacy script map handler.  
' The required properties are Name, Modules, and ScriptProcessor.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "ASPClassic"   
oHandler.Path="*.asp"   
oHandler.Verb="GET,HEAD,POST"   
oHandler.Modules="ISAPIModule"   
oHandler.ResourceType= 0 '0 is "File"  
oHandler.ScriptProcessor = "%windir%\system32\inetsrv\asp.dll"  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Create a native module handler for static files.  
' The required properties are Name, Modules, and Path.  
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "StaticFile"   
oHandler.Path="*"   
oHandler.Verb="*"   
oHandler.Modules="StaticFileModule,DefaultDocumentModule,DirectoryListingModule"  
oHandler.ResourceType=2  
oHandler.RequireAccess=1  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Create a native module handler for ISAPI DLLs.  
' The required properties are Name, Modules, and Path.  
oHandler.Name = "ISAPI-dll"   
oHandler.Path="*.dll"   
oHandler.Verb="*"   
oHandler.Modules="ISAPIModule"  
oHandler.ResourceType=0  
oHandler.RequireAccess=4  
oHandler.AllowPathInfo=True  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Add a managed handler.  
' The required properties are Name, Path, and Type.   
Set oHandler = oWebAdmin.Get("HandlerAction").SpawnInstance_  
oHandler.Name = "TraceHandler-Integrated"   
oHandler.Path="trace.axd"   
oHandler.Verb="GET,HEAD,POST"   
oHandler.Type="System.Web.Handlers.TraceHandler"  
oHandler.PreCondition="integratedMode"  
  
' Add the handler to the <handlers> section.  
oHandlersSection.Add "Handlers", oHandler  
  
' Call the WMI Refresh_ method to update the oHandlersSection object variable.  
oHandlersSection.Refresh_  
  
' Display the new list of handler names.   
WScript.Echo "---[New Handler List]---"  
Call DisplayHandlers  
  
' Provide a sub to display the handler names.  
Sub DisplayHandlers  
    For Each oHandler In oHandlersSection.Handlers  
         WScript.Echo "Name: " & oHandler.Name  
    Next  
    WScript.Echo  
End Sub

Иерархия наследования

CollectionElement

HandlerAction

Требования

Тип	Описание
клиент	— 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

См. также:

Класс AccessSection
Класс CollectionElement
Класс HandlersSection
Метод IScriptMapInfo::GetAllowPathInfoForScriptMappings

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

Класс HandlerAction

Синтаксис

Методы

Свойства

используются подклассы ;

Комментарии

Пример

Иерархия наследования

Требования

См. также:

Обратная связь

Дополнительные ресурсы