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>
요소 정보
구성 섹션 처리기 |
|
구성 멤버 |
|
구성 가능한 위치 |
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 |
참고 항목
작업
참조
customErrors에 대한 error 요소(ASP.NET 설정 스키마)