@ Control各属性说明（官网）

定义 ASP.NET 页分析器和编译器使用的特定于用户控件（.ascx 文件）的属性。此指令只能用于 ASP.NET 用户控件（其源代码包含在 .ascx 文件中）。

<%@ Control attribute="value" [attribute="value" ... ] %>

属性

AutoEventWireup

指示控件的事件是否自动匹配 (Autowire)。如果启用事件自动匹配，则为 true；否则为 false。默认值为 true。有关更多信息，请参见

ClassName

一个字符串，用于指定需在请求时进行动态编译的控件的类名。此值可以是任何有效的类名，并且可以包括类的完整命名空间（一个完全限定的类名）。如果没有为此属性指定值，已编译控件的类名将基于该控件的文件名。

通过使用

@ Reference 指令，另一个页或控件可以引用分配给该控件的类名。

CodeBehind

指定包含与控件关联的类的已编译文件的名称。该属性不能在运行时使用。

注意
包含此属性是为了与 ASP.NET 早期版本兼容，以实现代码隐藏功能。在 ASP.NET 2.0 版中，应当改用 CodeFile 属性指定源文件的名称，并用 Inherits 属性指定类的完全限定名。

CodeFile

指定所引用的控件代码隐藏文件的路径。此属性与 Inherits 属性一起使用，将代码隐藏源文件与用户控件相关联。该属性只对已编译控件有效。

CodeFileBaseClass

指定控件基类及其相关联的代码隐藏类的路径。此属性是可选的，但是使用该属性时，CodeFile 属性必须同时存在。可在实现共享方案时使用此属性，在共享方案下，您可在基类中定义公共字段（并可选择定义相关联的事件），以便引用在用户控件中声明的控件。根据 ASP.NET 代码生成模型，如果您没有使用此属性而在基类中定义了字段，则在编译时会为用户控件中声明的控件生成新的成员定义（在另一个分部类存根 (stub) 内），而您所需的方案将无法工作。但是，如果您使用 CodeFileBaseClass 属性将基类与用户控件相关联，并且让您的分部类（其名称分配给 Inherits 属性，其源文件由 CodeFile 属性引用）从基类继承，则基类中的字段在代码生成后将能够引用用户控件中的控件。

CompilationMode

使用一个指定几个枚举选项之一的字符串来设置是否编译控件。默认值为 Always，因此默认情况下编译 .aspx 控件。有关详细信息，请参见 CompilationMode 枚举。

CompilerOptions

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

Debug

指示是否应使用调试符号编译控件。如果应使用调试符号编译控件，则为 true；否则为 false。由于此设置将影响性能，因此应该只在开发期间将该属性设置为 true。

Description

提供控件的文本说明。ASP.NET 分析器忽略该值。

EnableTheming

指示控件上是否使用主题。如果使用主题，则为 true；否则为 false。默认值为 true。

EnableViewState

指示是否跨控件请求维护视图状态。如果维护视图状态，则为 true；否则为 false。默认值为 true。

Explicit

确定是否使用 Visual Basic Option Explicit 模式来编译控件。如果启用了 Visual Basic 显式编译选项，且所有变量必须使用 Dim、Private、Public 或 ReDim 语句来声明，则为 true；否则为 false。默认值为 false。

注意
除了 Visual Basic，所有其他语言都忽略此属性。此外，此选项在 Machine.config 配置文件中设置为 true。有关更多信息，请参见计算机配置文件。

Inherits

定义供控件继承的代码隐藏类。它可以是从 UserControl 类派生的任何类。与包含代码隐藏类源文件的路径的 CodeFile 属性一起使用。有关代码隐藏类的更多信息，请参见 ASP.NET 网页代码模型。

Language

指定在编译控件中所有内联呈现（<% %> 和 <%= %>）和代码声明块时使用的语言。值可以表示任何 .NET Framework 支持的语言，包括 Visual Basic、C# 或 JScript。对于每个控件，只能使用和指定一种语言。

LinePragmas

确定运行库是否应在源代码中生成行杂注。这些是调试工具常用来标记源文件中的特定位置的编译器选项。如果应生成行杂注，则为 true；否则为 false。

Src

指定包含链接到控件的代码的源文件的路径。在所链接的源文件中，您可选择在类中或在代码声明块中包括控件的编程逻辑。

可以使用 Src 属性将生成提供程序链接到控件。有关更多信息，请参见 BuildProvider 类。另外，在 ASP.NET 2.0 之前的版本中，Src 属性用作将代码隐藏文件链接到控件的一种备选方法。在 ASP.NET 2.0 版中，将代码隐藏源文件链接到控件的首选方法是使用 Inherits 属性指定一个类，并使用 CodeFile 属性指定该类的源文件的路径。

Strict

指示是否应使用 Visual Basic OptionStrict 模式来编译控件。如果启用了 Option Strict 则为 true；否则为 false。默认值为 false。

注意
除了 Visual Basic，所有其他语言都忽略此属性。

TargetSchema

指定用来验证控件上的内容的架构的名称。这只用于描述性目的；并不执行实际的验证，分析器将忽略该属性。

WarningLevel

指示您想要编译器在哪个编译器警告等级将警告作为错误来处理，并中止控件编译。警告等级可以是 0 到 4。有关更多信息，请参见 WarningLevel 属性。

ASP.NET Web 服务器控件事件模型。

备注

该指令只能用于用户控件中。用户控件在带有 .ascx 扩展名的文件中进行定义。每个 .ascx 文件只能包含一条 @ Control 指令。此外，对于每个 @ Control 指令，您只能定义一个 Language 属性，因为每个控件只能使用一种语言。

注意
@ Control 指令与适用于整个源文件的其他指令有许多共同的属性，例如 @ Page 指令（在网页的 .aspx 文件中使用）和 @ Master 指令（在母版页的 .master 文件中使用）。

若要定义 @ Control 指令的多个属性，请用一个空格分隔每个属性/值对。对于一个特定的属性，请勿在连接该属性与它的值的等号 (=) 的任一侧包含空格。有关示例，请参见本主题的“示例”一节。

示例

下面的代码示例指示 ASP.NET 页编译器使用 Visual Basic 作为内联代码语言，并使用 EnableViewState 属性禁止跨 HTTP 请求保存视图状态。

<%@ Control Language="VB" EnableViewState="false" %>

复制代码