@ 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 注册首选文件扩展名。有关详细信息,请参见 如何:注册 HTTP 处理程序。 |
每个文件只能包含一条 @ WebHandler 指令。 由于每个处理程序只能使用一种语言,因此每条 @ WebHandler 指令只能定义一个 Language 特性。
注意 |
---|
@ WebHandler 指令与适用于整个源文件的其他指令有许多共同的特性,例如在网页的 .aspx 文件中使用的 @ Page 指令。 |
若要定义 @ WebHandler 指令的多个特性,请用一个空格分隔每个特性/值对。 不要在将特性与其值相连的等号 (=) 的任一侧包含空格。
示例
下面的代码示例指示 ASP.NET 页编译器使用 Visual Basic 作为内联代码语言并指定了类名。
<%@ WebHandler Language="VB" Class="MyTestHandler" %>