@ Application — Global.asax

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

定义 ASP.NET 应用程序编译器所使用的应用程序特定的特性,它只显示在应用程序文件 (.asax) 中。

<%@ Application attribute="value" [attribute=value … ]%>

特性

  • CodeBehind
    指定源代码文件的名称,该文件包含与应用程序类相关联的类。 ASP.NET 分析器将忽略此特性;此特性只在设计时由集成开发环境 (IDE) 工具(如 Microsoft Visual Studio 2005)使用。

    备注

    提供此特性是为了与以前版本的 ASP.NET 兼容,以实现代码隐藏功能。在 ASP.NET 2.0 版中,应改用 CodeFile 特性指定该源文件的名称,同时使用 Inherits 特性指定该类的完全限定名称。

  • CompilerOptions
    包含用于编译页的编译器选项的字符串。 在 C# 和 Visual Basic 中,这是编译器命令行开关的序列。 有关编译器选项的更多信息,请参见 C# 编译器选项Visual Basic 命令行编译器

  • Description
    应用程序类的文本说明。 ASP.NET 分析器忽略该值。

  • Inherits
    定义供应用程序类继承的代码隐藏类。 它可以是从 HttpApplication 类派生的任何类。 它与 CodeFile 特性(包含指向代码隐藏类的源文件的路径)一起使用。 有关代码隐藏类的更多信息,请参见 ASP.NET Web Page Code Model

  • Language
    指定在对应用程序文件中所有内联呈现(<% %> 和 <%= %>)和代码声明块进行编译时使用的语言。 值可以表示任何 .NET Framework 支持的语言,包括 Visual Basic、C# 或 JScript。 每个应用程序文件只能使用和指定一种语言。

备注

Description 和 Inherits 特性可以同时在同一 @ Application 指令中声明,如下面的“示例”部分所示。

如果要对应用程序类使用代码分离,必须使用 Inherits 特性指定该应用程序类将从其继承的代码隐藏类的名称。 或者,如果使用的 IDE(如 Microsoft Visual Studio 2005)提供了用于在代码项目中处理代码分离源文件的工具,则可以添加 CodeFile 特性来指定代码隐藏源文件名。

示例

下面的代码示例指示 ASP.NET 应用程序编译器动态编译新的应用程序类,该应用程序类扩展 My401kApp.Object 类。

<%@ Application Inherits="My401kApp.Object" Description="Our 401k app" %>

请参见

参考

应用程序指令

其他资源

Global.asax 语法