다음을 통해 공유


customErrors 요소(ASP.NET 설정 스키마)

ASP.NET 응용 프로그램의 사용자 지정 오류 메시지에 대한 정보를 제공합니다. customErrors 요소는 응용 프로그램 파일 계층 구조의 모든 수준에 정의할 수 있습니다.

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

특성 및 요소

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

특성

특성

설명

defaultRedirect

선택적 특성입니다.

오류가 발생할 경우 브라우저에 표시할 기본 URL을 지정합니다. 이 특성을 지정하지 않으면 일반 오류가 대신 표시됩니다.

URL은 절대적(예: www.contoso.com/ErrorPage.htm)이거나 상대적일 수 있습니다. /ErrorPage.htm과 같은 상대 URL은 오류가 발생한 웹 페이지가 아니라 이 특성에 URL을 지정한 Web.config 파일에 상대적입니다. ~/ErrorPage.htm과 같이 물결표(~)로 시작되는 URL은 지정된 URL이 응용 프로그램의 루트 경로에 상대적임을 나타냅니다.

mode

필수 특성입니다.

사용자 지정 오류를 설정할지, 해제할지 또는 원격 클라이언트에만 표시할지 여부를 지정합니다.

이 특성은 다음 값 중 하나일 수 있습니다.

값설명
On 사용자 지정 오류가 설정되었음을 지정합니다.defaultRedirect 특성을 지정하지 않으면 일반 오류가 발생합니다.원격 클라이언트 및 로컬 호스트에 사용자 지정 오류가 표시됩니다.
Off 사용자 지정 오류가 해제되었음을 지정합니다.원격 클라이언트 및 로컬 호스트에 자세한 ASP.NET 오류가 표시됩니다.
RemoteOnly 사용자 지정 오류는 원격 클라이언트에만 표시되고 ASP.NET 오류는 로컬 호스트에만 표시되도록 지정합니다.기본값입니다.

기본값은 RemoteOnly입니다.

redirectMode

선택적 특성입니다.

사용자 지정 오류 페이지가 표시되었을 때 원래 요청의 URL을 처리하는 방법에 대한 값을 지정합니다.

이 특성은 다음 값 중 하나일 수 있습니다.

값설명
ResponseRedirect 브라우저에 연결할 URL이 원래 웹 요청 URL과 다르도록 지정합니다.
ResponseRewrite 브라우저에 연결할 URL이 원래 웹 요청 URL과 같도록 지정합니다.

자식 요소

요소

설명

error

선택적 요소입니다.

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

error 태그는 여러 번 나타날 수 있습니다. 각 error 하위 태그는 하나의 사용자 지정 오류 조건을 정의합니다.

부모 요소

요소

설명

configuration

공용 언어 런타임 및 .NET Framework 응용 프로그램에서 사용하는 모든 구성 파일의 루트 요소를 지정합니다.

system.web

구성 파일에서 ASP.NET 구성 설정에 대한 루트 요소를 지정하며, ASP.NET 웹 응용 프로그램을 구성하고 응용 프로그램의 동작 방식을 제어하는 구성 요소를 포함합니다.

설명

기본 구성

다음의 기본 customErrors 요소는 .NET Framework 버전 1.0 및 1.1의 Machine.config 파일에 구성되어 있습니다.

<customErrors mode="RemoteOnly" />

예제

다음 구성 예제에서는 ASP.NET 응용 프로그램에 사용할 오류 처리 페이지를 지정하는 방법을 보여 줍니다.

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

요소 정보

구성 섹션 처리기

System.Web.Configuration.CustomErrorsSection

구성 멤버

SystemWebSectionGroup.CustomErrors

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

참고 항목

작업

방법: ASP.NET 구성 설정 잠금

참조

system.web 요소(ASP.NET 설정 스키마)

configuration 요소(일반 설정 스키마)

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

System.Configuration

System.Web.Configuration

개념

ASP.NET 구성 개요

ASP.NET 웹 서버 컨트롤 및 브라우저 기능

ASP.NET 구성 보안

ASP.NET 구성 시나리오

기타 리소스

ASP.NET 구성 파일

ASP.NET 구성 설정

일반 구성 설정(ASP.NET)

ASP.NET 구성 API