@ WebHandler
업데이트: 2007년 11월
HTTP 처리기 파일(.ashx)의 특성 및 컴파일 옵션을 정의합니다.
<%@ WebHandler attribute="value" [attribute="value"...] %>
특성
Class
처리기가 요청될 때 동적으로 컴파일되는 클래스의 이름을 지정합니다. 이 값은 IHttpHandler를 상속하는 모든 클래스를 참조할 수 있으며 정규화된 클래스 이름을 포함할 수 있습니다.CodeBehind
처리기와 연결된 클래스를 포함하는 컴파일된 파일의 이름을 지정합니다. 이 특성은 런타임에는 사용되지 않습니다.참고
이 특성은 이전 버전의 ASP.NET과의 호환성을 위해 포함되었습니다.
CompilerOptions
처리기를 컴파일할 때 사용하는 옵션이 들어 있는 문자열을 지정합니다. C#과 Visual Basic에서 이 특성은 컴파일러 명령줄 스위치 시퀀스입니다. 컴파일러 옵션에 대한 자세한 내용은 C# 컴파일러 옵션 및 Visual Basic 컴파일러를 참조하십시오.Debug
디버그 기호를 사용하여 처리기를 컴파일해야 하는 경우 true이고, 그렇지 않은 경우 false입니다. 이 설정은 성능에 영향을 주므로 개발하는 동안에만 이 특성을 true로 설정해야 합니다.Description
처리기에 대한 텍스트 설명을 제공합니다. 이 값은 ASP.NET 파서에서는 무시됩니다.Language
처리기 내의 모든 코드를 컴파일할 때 사용되는 언어를 지정합니다. 값은 Visual Basic, C# 또는 JScript를 비롯한 모든 .NET Framework 언어를 나타낼 수 있습니다. 처리기마다 하나의 언어만 사용할 수 있습니다.WarningLevel
컴파일러에서 경고를 오류로 처리하여 처리기 컴파일을 중단할 컴파일러 경고 수준을 나타냅니다. 가능한 경고 수준은 0에서 4까지입니다. 자세한 내용은 WarningLevel 속성을 참조하십시오.
설명
이 지시문은 HTTP 처리기로 사용되는 파일에서만 유효합니다. 기본적으로 ASP.NET에서는 확장명이 .ashx인 파일을 처리기로 간주합니다.
참고
처리기로 .ashx 파일 확장명을 사용하지 않으려는 경우 처리기를 IHttpHandler 인터페이스를 구현하는 표준 클래스(.cs 또는 .vb 파일)로 만들 수 있습니다. 처리기 클래스 파일에는 @ WebHandler 지시문이 필요하지 않습니다. 그런 다음 사용할 파일 확장명을 ASP.NET에 등록해야 합니다. 자세한 내용은 방법: HTTP 처리기 등록을 참조하십시오.
각 파일에는 @ WebHandler 지시문이 하나만 포함될 수 있습니다. 처리기마다 하나의 언어만 사용할 수 있으므로 @ WebHandler 지시문마다 Language 특성을 하나만 정의할 수 있습니다.
참고
@ WebHandler 처리기는 웹 페이지의 .aspx 파일에 사용되는 @ Page 지시문과 같이 전체 소스 파일에 적용되는 다른 지시문과 몇 가지 특성을 공유합니다.
@ WebHandler 지시문에 여러 특성을 정의하려면 각 특성/값 쌍을 단일 공백으로 구분합니다. 특성과 값을 연결하는 등호(=) 앞뒤에 공백을 넣으면 안 됩니다.
예제
다음 코드 예제에서는 ASP.NET 페이지 컴파일러에서 Visual Basic을 인라인 코드 언어로 사용하도록 지시하고 클래스 이름을 지정합니다.
<%@ WebHandler Language="VB" Class="MyTestHandler" %>