handlers Element [IIS Settings Schema]

2021-10-21

Note

For more information about the handlers element, see the following topic on the Microsoft IIS.net Web site: Handlers <handlers>.

Specifies handlers to process requests made to sites and applications.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

accessPolicy

Optional flags attribute.

Specifies the allowed access types for the entire handlers collection.

The accessPolicy attribute can be one of the following possible values. The default is Read.

Value	Description
Execute	Enables handlers in the handlers collection that require execute rights in directories and files.
None	Disables all handlers in the handlers collection that require access to directories or files.
NoRemoteExecute	Prevents handlers in the handlers collection from running executables when a handler receives a remote request.
NoRemoteRead	Prevents handlers in the handlers collection from reading files when a handler receives a remote request.
NoRemoteScript	Prevents handlers in the handlers collection from running scripts when a handler receives a remote request.
NoRemoteWrite	Prevents handlers in the handlers collection from creating or changing files when a handler receives a remote request.
Read	Enables handlers in the handlers collection that require read access to directories and files.
Script	Enables handlers in the handlers collection that require script rights to directories or files.
Source	Enables handlers in the handlers collection that require read access to source code (together with the Read flag) or write access to source code (together with the Write flag).
Write	Enables handlers in the handlers collection that require write access to directories and files.

Child Elements

Element	Description
add	Optional element. Adds a handler to the collection of handlers.
clear	Optional element. Removes all references to handlers from the handlers collection.
remove	Optional element. Removes a reference to a handler from the handlers collection.

add

Optional element.

Adds a handler to the collection of handlers.

clear

Optional element.

Removes all references to handlers from the handlers collection.

remove

Optional element.

Removes a reference to a handler from the handlers collection.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by IIS 7.
system.webServer	Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.

Remarks

For more information about the handlers element, see the following topic on the Microsoft IIS.net Web site: Handlers <handlers>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Directory Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

Share via

handlers Element [IIS Settings Schema]

Syntax

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Element Information

See Also

Reference

Additional resources