所有的 Web 控件都继承自 WebControl 类,WebControl 类继承自 Control 类
本章列出了 ASP.NET 控件的标准属性,也就是 Control 类的属性
属性 | 描述 | .NET |
---|---|---|
AppRelativeTemplateSourceDirectory | 获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录 | 1.0 |
BindingContainer | 获取包含该控件的数据绑定的控件 | 1.0 |
ClientID | 获取由 ASP.NET 生成的服务器控件标识符 | 1.0 |
Controls | 获取 ControlCollection 对象,该对象表示 UI 层次结构中指定服务器控件的子控件 | 1.0 |
EnableTheming | 获取或设置一个值,该值指示主题是否应用于该控件 | 1.0 |
EnableViewState | 获取或设置一个值,该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态 | 1,0 |
ID | 分配给该控件的 id | 2.0 |
NamingContainer | 获取对服务器控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 id 属性值的服务器控件 | 1.0 |
Page | 对包含该控件的页面的引用 | 1.0 |
Parent | 对该控件的父控件的引用 | 2.0 |
Site | 获取有关当前控件的容器的信息 | 2.0 |
TemplateControl | 获取或设置对包含当前控件的模板的引用 | 1.0 |
TemplateSourceDirectory | 获取包含当前控件的页面或控件的虚拟目录 | 1.0 |
UniqueID | 获取服务器控件的唯一的、以分层形式限定的自动生成的标识符 | 1.0 |
Visible | 获取或设置一个值,该值指示服务器控件是否作为 UI 呈现在页上 | 1.0 |
ASP.NET BindingContainer 属性
ASP.NET BindingContainer 属性获取包含该控件的数据绑定的控件
BindingContainer 属性包含对 Control 对象的引用,该对象包含当前控件的数据绑定信息
该属性支持 .NET 基础结构,但不适合在代码中直接使用
BindingContainer 属性与 NamingContainer 属性相同,在控件是模板的一部分时除外,在这种情况下,BindingContainer 属性设置为定义模板的 Control
范例
下面的范例显示 Button 控件的 BindingContainer
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Response.Write("The binding container is: ")
Response.Write(button1.BindingContainer)
End Sub
</script>
<form runat="server" >
<asp:Button ID="button1" OnClick="Button1_Click"
Text="Get BindingContainer" runat="server" />
</form>
ASP.NET ClientID 属性
ASP.NET ClientID 属性获取由 ASP.NET 自动生成的控件标识符
范例
下面的范例显示 Button 控件的 ClientID
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Response.Write("The ClientID of the button is: ")
Response.Write(button1.ClientID)
End Sub
</script>
<form runat="server" >
<asp:Button ID="button1" OnClick="Button1_Click"
Text="Get ClientID" runat="server" />
</form>
ASP.NET ID 属性
ASP.NET ID 属性获取或设置分配给控件的编程标识符
通常情况下都会设置该属性,在当前控件与其他控件或脚本交互时使用该属性
设置控件上的该属性可提供对控件的属性、事件和方法的编程访问
Web 开发人员可以通过在 ASP.NET 控件的开始标记中声明 ID 属性来设置该属性
如果没有为控件指定该属性(以声明方式或编程方式),则可通过其父控件的 Controls 属性获取对该控件的引用
语法
<asp: webcontrol id="id" runat="server" />
范例
下面的范例显示设置了 ID 属性的 Button 控件
<form runat="server">
<asp:Button id="button" text="Submit" runat="server" />
</form>
ASP.NET NamingContainer 属性
ASP.NET NamingContainer 属性获取对控件的命名容器的引用,此引用创建唯一的命名空间,以区分具有相同 Control.ID 属性值的控件
范例
下面的范例显示 Button 控件的 NamingContainer
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Response.Write("The naming container is: ")
Response.Write(button1.NamingContainer)
End Sub
</script>
<form runat="server" >
<asp:Button ID="button1" OnClick="Button1_Click"
Text="Get NamingContainer" runat="server" />
</form>
ASP.NET Page 属性
ASP.NET Page 属性获取对包含控件的 Page 实例的引用
该属性的值反映了包含控件的 .aspx 文件的名称
范例
下面的范例显示包含 Button 控件的 Page
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Response.Write("The Page containing the button is: ")
Response.Write(button1.Page)
End Sub
</script>
<form runat="server" >
<asp:Button ID="button1" OnClick="Button1_Click"
Text="Get Page" runat="server" />
</form>
ASP.NET Parent 属性
ASP.NET Parent 属性获取对控件的父控件的引用
范例
下面的范例显示包含 Button 控件的 Parent 元素
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Response.Write("The Parent of the button control is: ")
Response.Write(button1.Parent)
End Sub
</script>
<form runat="server" >
<asp:Button ID="button1" OnClick="Button1_Click"
Text="Get Parent" runat="server" />
</form>
ASP.NET UniqueID 属性
ASP.NET UniqueID 属性获取控件的唯一的、以分层形式限定的自动生成的标识符
该属性与 ID 属性不同,因为 UniqueID 属性包含控件命名容器的标识符,处理页请求时自动生成该标识符
范例
下面的范例显示 Button 控件的 UniqueID
<script runat="server">
Sub Button1_Click(sender As Object, e As EventArgs)
Response.Write("UniqueID is: " & button1.UniqueID)
End Sub
</script>
<form runat="server" >
<asp:Button ID="button1" OnClick="Button1_Click"
Text="Get UniqueID" runat="server" />
</form>
ASP.NET Visible 属性
ASP.NET Visible 属性获取或设置一个值,该值指示控件是否呈现在页上
语法
<asp:webcontrol id="id" Visible="True|False" runat="server" />
范例
下面的范例代码设置按钮不可见
<form runat="server">
<asp:Button id="button1" Text="Submit"
Visible="False" runat="server" />
</form>