Use the Handler Mappings feature page to manage a list of handlers that process requests for specific file types.

Sort the list by clicking one of the feature page column headings or select a value from the Group by drop-down list to group similar items.

UI Element List

The following tables describe the UI elements that are available on the feature page and in the Actions pane.

Feature Page Elements

Element Name Description

Name

Displays the name of the handler mapping.

Path

Displays the file name or file name extension for which the handler will process a response. The value can be either a specific file name, such as WebResource.axd, or a wildcard (*) with a specific extension, such as *.exe.

State

Displays whether the handler is enabled or disabled based on the access policy set in the Edit Feature Permissions dialog box and the required access setting specified by the handler mapping. If a handler requires a type of access that is not enabled in the access policy at that level, the handler is disabled.

Path Type

Displays one of the following values for the type of path to which the handler is mapped:

  • Unspecified, if the mapping does not apply to a specific path type.

  • File, if the mapping applies to a file.

  • Directory, if the mapping applies to a directory.

  • File or Directory, if the mapping is for either a file or a directory.

Handler

Displays the module, such as IsapiModule, or managed type, such as System.Web.Handlers.TraceHandler, that responds to the request as specified in the mapping.

Entry Type

Displays whether the item is local or inherited. Local items are read from the current configuration file, and inherited items are read from a parent configuration file.

Actions Pane Elements

Element Name Description

Add Managed Handler

Opens the Add Managed Handler dialog box in which you can add a mapping to a managed code handler.

Add Script Map

Opens the Add Script Map dialog box in which you can add a mapping to a script processor.

Add Wildcard Script Map

Opens the Add Wildcard Script Map dialog box in which you can add a handler mapping to handle every file name extension.

Add Module Mapping

Opens the Add Module Mapping dialog box in which you can add a mapping to a module.

Edit

Opens an edit dialog box from which you can edit the selected handler mapping.

Rename

Enables the Name field so you can change the friendly name of the selected handler mapping.

Note

This action is available only at the server level.

Lock

Locks the selected handler mapping so it cannot be overridden at lower levels in configuration.

Note

This action is available only at the server level.

Unlock

Unlocks the selected handler mapping so it can be overridden at lower levels in configuration.

Note

This action is available only at the server level.

Remove

Removes the item that is selected from the list on the feature page.

Edit Feature Permissions

Opens the Edit Feature Permissions dialog box in which you can configure permissions that apply to the entire Handler Mappings feature.

Revert to Inherited

Reverts the feature to inherit settings from the parent configuration. This deletes local configuration settings, including items from the list, for this feature. This action is not available at the server level.

View Ordered List

Displays the list in order of configuration. When you select the ordered list format, you can only move items up and down in the list. Other actions in the Actions pane do not appear until you select the unordered list format.

Move Up

Moves a selected item up in the list. This action is available only when viewing items in the ordered list format.

Note

When items in the list are reordered at a child level, the child will no longer inherit settings from the parent level (including any items that are added to or removed from the list at the parent level) after the list is reordered. If you want to inherit settings from a parent level, you must revert all of the changes at the child level by using the Revert to Inherited action in the Actions pane.

Move Down

Moves a selected item down in the list. This action is available only when viewing items in the ordered list format.

Note

When items in the list are reordered at a child level, the child will no longer inherit settings from the parent level (including any items that are added to or removed from the list at the parent level) after the list is reordered. If you want to inherit settings from a parent level, you must revert all of the changes at the child level by using the Revert to Inherited action in the Actions pane.

View Unordered List

Displays the list in an unordered format. When you select the unordered list format, you can sort and group items in the list, and perform actions in the Actions pane.

See Also