@ WebHandler
HTTP 처리기 파일(.ashx)의 특성 및 컴파일 옵션을 정의합니다.
<%@ WebHandler attribute="value" [attribute="value"...] %>
특성
Class
처리기가 요청될 때 동적으로 컴파일되는 클래스의 이름을 지정합니다. 이 값은 IHttpHandler를 상속하는 모든 클래스를 참조할 수 있으며 정규화된 클래스 이름을 포함할 수 있습니다.CodeBehind
처리기와 연결된 클래스를 포함하는 컴파일된 파일의 이름을 지정합니다. 이 특성은 런타임에는 사용되지 않습니다..gif "참고")
참고이 특성은 이전 버전의 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" %>