httpErrors Element [IIS Settings Schema]

Article
10/21/2021

Note

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

Configures HTTP error messages for a Web server.

Syntax

Attributes and Elements

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

Attributes

defaultPath

Optional string attribute.

Specifies the default path of the custom error page. The type of path is determined by the defaultResponseMode attribute. If you choose File, the file path is returned. If you choose either the ExecuteURL or Redirect path type, the URL of the custom error page is returned.

defaultResponseMode

Optional enum attribute.

Specifies how custom error content is returned.

The defaultResponseMode attribute can be one of the following possible values. The default is File.

Value	Description
File	Serves static content, for example, a .html file for the custom error. If responseMode is set to File, the path value has to be a file path. The numeric value is 0.
ExecuteURL	Serves dynamic content, for example, a .asp file for the custom error. If responseMode is set to ExecuteURL, the path value has to be a server relative URL. The numeric value is 1.
Redirect	Redirects client browsers to a different URL that contains the custom error file. If responseMode is set to Redirect, the path value has to be an absolute URL. The numeric value is 2.

detailedMoreInformationLink

Optional string attribute.

Specifies a link, shown at the bottom of the page, to a page with more detailed information about a particular error. You can use this property to point end users to a custom location for error information. The status, sub-status, hresult and message ID are sent as part of the query string.

The default value is "https://go.microsoft.com/fwlink/?LinkID=62293".

errorMode

Optional enum attribute.

Specifies whether HTTP errors are enabled.

The errorMode attribute can be one of the following values. The default is DetailedLocalOnly.

Value	Description
DetailedLocalOnly	Returns detailed error information if the request is from the local computer, and returns a custom error message if the request is from an external computer. The numeric value is 0.
Custom	Replaces the error that the module or server generates with a custom page that you specify. This mode is useful in providing friendlier error messages to end users. The numeric value is 1. Note This setting turns off detailed errors, even for local requests.
Detailed	Sends detailed error information back to the client. This mode is useful for testing and debugging Web sites and applications. The numeric value is 2.

existingResponse

Optional enum attribute.

Specifies what happens to an existing response when the HTTP status code is an error, i.e. response codes >= 400.

Value	Description
Auto	Leaves the response untouched only if the SetStatus flag is set. The numeric value is 0.
Replace	Replaces the existing response even if the SetStatus flag is set. The numeric value is 1.
PassThrough	Leaves the response untouched if an existing response exists. The numeric value is 2.

Child Elements

Element	Description
error	Optional element. Adds an HTTP error to the collection of HTTP errors.
remove	Optional element. Removes a reference to an HTTP error from the HTTP error collection.
clear	Optional element. Removes all references to HTTP errors from the HTTP error collection.

error

Optional element.

Adds an HTTP error to the collection of HTTP errors.

remove

Optional element.

Removes a reference to an HTTP error from the HTTP error collection.

clear

Optional element.

Removes all references to HTTP errors from the HTTP error 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 httpErrors element, see the following topic on the Microsoft IIS.net Web site: HTTP Errors <httpErrors>.

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

Partager via

httpErrors Element [IIS Settings Schema]

Syntax

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

Element Information

See Also

Reference

Ressources supplémentaires