@ Control各属性说明(官网)

本文档详细阐述了在ASP.NET中,针对用户控件(.ascx文件)的解析器和编译器所使用的特定属性。这些属性对理解和操作用户控件的编译过程至关重要。

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

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

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

ClassName

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

通过使用

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

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

Note注意

包含此属性是为了与 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 显式编译选项,且所有变量必须使用 DimPrivatePublicReDim 语句来声明,则为 true;否则为 false。默认值为 false

Note注意

除了 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

Note注意

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

TargetSchema

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

WarningLevel

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

ASP.NET Web 服务器控件事件模型
 
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值