@ WebHandler
[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]
定义 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
指定编译处理程序中的所有代码时使用的语言。 值可以表示任何 .NET Framework 语言，包括 Visual Basic、C# 或 JScript。 每个处理程序只能使用一种语言。WarningLevel
指示您希望编译器将警告视为错误（从而停止对处理程序进行编译）的编译器警告级别。 可能的警告等级为 0 到 4。 有关更多信息，请参见 WarningLevel 属性。
备注
此指令仅在用作 HTTP 处理程序的文件中有效。 默认情况下，ASP.NET 将扩展名为 .ashx 的文件视为处理程序。
备注
如果您不希望对处理程序使用 .ashx 文件扩展名，则可以创建作为标准类（.cs 或 .vb 文件）的处理程序，此标准类实现 IHttpHandler 接口。处理程序类文件不要求 @ WebHandler 指令。您然后必须使用 ASP.NET 注册首选文件扩展名。有关详细信息，请参见How to: Register HTTP Handlers。
每个文件只能包含一条 @ WebHandler 指令。 由于每个处理程序只能使用一种语言，因此每条 @ WebHandler 指令只能定义一个 Language 特性。
备注
@ WebHandler 指令与适用于整个源文件的其他指令有许多共同的特性，例如在网页的 .aspx 文件中使用的 @ Page 指令。
若要定义 @ WebHandler 指令的多个特性，请用一个空格分隔每个特性/值对。 不要在将特性与其值相连的等号 (=) 的任一侧包含空格。
示例
下面的代码示例指示 ASP.NET 页编译器使用 Visual Basic 作为内联代码语言并指定了类名。
<%@ WebHandler Language="VB" Class="MyTestHandler" %>