customErrors에 대한 error 요소(ASP.NET 설정 스키마)

아티클
05/27/2012

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

제공된 HTTP 상태 코드에 대한 사용자 지정 오류 페이지를 지정합니다.

<error statusCode="statuscode"
       redirect="url"/>

특성 및 요소

다음 단원에서는 특성, 자식 요소 및 부모 요소에 대해 설명합니다.

특성

특성	설명
statusCode	필수 특성입니다. 오류 페이지로 리디렉션되는 HTTP 상태 코드를 지정합니다.
redirect	필수 특성입니다. 오류 코드에 매핑된 사용자 지정 페이지의 URL입니다.

statusCode

필수 특성입니다.

오류 페이지로 리디렉션되는 HTTP 상태 코드를 지정합니다.

redirect

필수 특성입니다.

오류 코드에 매핑된 사용자 지정 페이지의 URL입니다.

자식 요소

없음

부모 요소

요소	설명
configuration	공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 필수 루트 요소를 지정합니다.
system.web	ASP.NET 구성 섹션의 루트 요소를 지정합니다.
customErrors	ASP.NET 응용 프로그램의 사용자 지정 오류 메시지에 대한 정보를 제공합니다. 이 요소는 응용 프로그램 파일 계층의 모든 수준에서 정의할 수 있습니다.

예제

다음 구성 코드 예제에서는 ASP.NET 응용 프로그램에 사용할 오류 처리 페이지를 지정합니다.

사용자 지정 오류는 ASP.NET에서 처리되는 요소에 대해서만 발생합니다. 예를 들어 존재하지 않는 .htm 페이지를 참조하는 경우에는 Microsoft IIS(인터넷 정보 서비스)에서 표준 404 오류를 발생시킵니다. 존재하지 않는 .aspx 페이지를 참조하는 경우에는 ASP.NET에서 사용자 지정 404 오류(구성한 경우)를 발생시킵니다.

<configuration>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
                  mode="RemoteOnly">
       <error statusCode="500"
              redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

요소 정보

구성 섹션 처리기	System.Web.Configuration.CustomErrorsSection
구성 멤버	System.Web.Configuration.CustomErrorsMode
구성 가능한 위치	Machine.config 루트 수준의 Web.config 응용 프로그램 수준의 Web.config 가상 또는 실제 디렉터리 수준의 Web.config
요구 사항	Microsoft IIS(인터넷 정보 서비스) 버전 5.0, 5.1 또는 6.0 .NET Framework 버전 1.0, 1.1 또는 2.0 Microsoft Visual Studio 2003 또는 Visual Studio 2005

참고 항목

Share via