ASP.NET - 基本控件



本章将讨论 ASP.NET 中提供的基本控件。

按钮控件

ASP.NET 提供三种类型的按钮控件

  • 按钮 (Button):在矩形区域内显示文本。

  • 链接按钮 (Link Button):显示看起来像超链接的文本。

  • 图片按钮 (Image Button):显示图像。

当用户单击按钮时,会引发两个事件:Click 和 Command。

按钮控件的基本语法

<asp:Button ID="Button1" runat="server" onclick="Button1_Click" Text="Click" / >

按钮控件的常用属性

属性 描述
Text 在按钮上显示的文本。仅适用于按钮和链接按钮控件。
ImageUrl 仅适用于图片按钮控件。按钮要显示的图像。
AlternateText 仅适用于图片按钮控件。如果浏览器无法显示图像,则显示的文本。
CausesValidation 确定用户单击按钮时是否发生页面验证。默认值为 true。
CommandName 用户单击按钮时传递给命令事件的字符串值。
CommandArgument 用户单击按钮时传递给命令事件的字符串值。
PostBackUrl 用户单击按钮时请求的页面的 URL。

文本框和标签

文本框控件通常用于接受用户的输入。文本框控件可以接受一行或多行文本,具体取决于 TextMode 属性的设置。

标签控件提供了一种简单的方法来显示文本,该文本可以在页面的每次执行之间更改。如果要显示不变的文本,则可以使用文字文本。

文本控件的基本语法

<asp:TextBox ID="txtstate" runat="server" ></asp:TextBox>

文本框和标签的常用属性

属性 描述
TextMode 指定文本框的类型。SingleLine 创建标准文本框,MultiLine 创建接受多行文本的文本框,Password 会使输入的字符被屏蔽。默认为 SingleLine。
Text 文本框的文本内容。
MaxLength 可以输入到文本框中的最大字符数。
Wrap 确定多行文本框中的文本是否自动换行;默认为 true。
ReadOnly 确定用户是否可以更改框中的文本;默认为 false,即用户无法更改文本。
Columns 文本框的宽度(以字符为单位)。实际宽度根据用于文本输入的字体确定。
Rows 多行文本框的高度(以行为单位)。默认值为 0,表示单行文本框。

标签控件最常用的属性是“Text”,它表示在标签上显示的文本。

复选框和单选按钮

复选框显示用户可以选中或取消选中的单个选项,而单选按钮则提供一组选项,用户只能从中选择一个选项。

要创建一组单选按钮,请为组中每个单选按钮的 GroupName 属性指定相同的名称。如果单个表单中需要多个组,则为每个组指定不同的组名。

如果希望在最初显示表单时选中复选框或单选按钮,请将其 Checked 属性设置为 true。如果组中多个单选按钮的 Checked 属性设置为 true,则只有最后一个被视为 true。

复选框的基本语法

<asp:CheckBox ID= "chkoption" runat= "Server"> 
</asp:CheckBox>

单选按钮的基本语法

<asp:RadioButton ID= "rdboption" runat= "Server"> 
</asp: RadioButton>

复选框和单选按钮的常用属性

属性 描述
Text 复选框或单选按钮旁边显示的文本。
Checked 指定它是否被选中,默认为 false。
GroupName 控件所属的组的名称。

列表控件

ASP.NET 提供以下控件

  • 下拉列表
  • 列表框
  • 单选按钮列表
  • 复选框列表
  • 项目符号列表

这些控件允许用户从列表中选择一个或多个项目。列表框和下拉列表包含一个或多个列表项。这些列表可以通过代码或 ListItemCollection 编辑器加载。

列表框控件的基本语法

<asp:ListBox ID="ListBox1" runat="server" AutoPostBack="True"    OnSelectedIndexChanged="ListBox1_SelectedIndexChanged">
</asp:ListBox>

下拉列表控件的基本语法

<asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True"   OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged">
</asp:DropDownList>

列表框和下拉列表的常用属性

属性 描述
Items 表示控件中项目的 ListItem 对象集合。此属性返回 ListItemCollection 类型的对象。
Rows 指定在框中显示的项目数。如果实际列表包含的行数多于显示的行数,则会添加滚动条。
SelectedIndex 当前选中项目的索引。如果选择了多个项目,则为第一个选中项目的索引。如果没有选中任何项目,则此属性的值为 -1。
SelectedValue 当前选中项目的 value 值。如果选择了多个项目,则为第一个选中项目的 value 值。如果没有选中任何项目,则此属性的值为空字符串 (“”)。
SelectionMode 指示列表框是否允许单选或多选。

每个列表项对象的常用属性

属性 描述
Text 为项目显示的文本。
Selected 指示项目是否被选中。
Value 与项目关联的字符串值。

需要注意的是

  • 要使用下拉列表或列表框中的项目,请使用控件的 Items 属性。此属性返回一个 ListItemCollection 对象,其中包含列表的所有项目。

  • 当用户从下拉列表或列表框中选择不同的项目时,将引发 SelectedIndexChanged 事件。

ListItemCollection

ListItemCollection 对象是 ListItem 对象的集合。每个 ListItem 对象代表列表中的一个项目。ListItemCollection 中的项目从 0 开始编号。

当使用字符串(例如:lstcolor.Items.Add("Blue"))将项目加载到列表框中时,列表项的 Text 和 Value 属性都将设置为指定的字符串值。要分别设置它们,必须创建一个列表项对象,然后将该项目添加到集合中。

ListItemCollection 编辑器用于向下拉列表或列表框添加项目。这用于创建静态项目列表。要显示集合编辑器,请从智能标记菜单中选择“编辑项目”,或选择控件,然后单击“属性”窗口中“项目”属性的省略号按钮。

ListItemCollection 的常用属性

属性 描述
Item(integer) 表示指定索引处的项目的 ListItem 对象。
Count 集合中的项目数。

ListItemCollection 的常用方法

方法 描述
Add(string) 在集合末尾添加一个新项目,并将字符串参数赋给项目的 Text 属性。
Add(ListItem) 在集合末尾添加一个新项目。
Insert(integer, string) 在集合的指定索引位置插入一个项目,并将字符串参数赋给项目的 Text 属性。
Insert(integer, ListItem) 在集合的指定索引位置插入项目。
Remove(string) 删除文本值与字符串相同的项目。
Remove(ListItem) 删除指定的项目。
RemoveAt(integer) 删除指定索引处的项目。
Clear 删除集合中的所有项目。
FindByValue(string) 返回 value 值与字符串相同的项目。
FindByText(string) 返回 text 值与字符串相同的项目。

单选按钮列表和复选框列表

单选按钮列表提供一组互斥选项。复选框列表提供一组独立选项。这些控件包含一个 ListItem 对象集合,可以通过控件的 Items 属性引用。

单选按钮列表的基本语法

<asp:RadioButtonList ID="RadioButtonList1" runat="server" AutoPostBack="True" 
   OnSelectedIndexChanged="RadioButtonList1_SelectedIndexChanged">
</asp:RadioButtonList>

复选框列表的基本语法

<asp:CheckBoxList ID="CheckBoxList1" runat="server" AutoPostBack="True" 
   OnSelectedIndexChanged="CheckBoxList1_SelectedIndexChanged">
</asp:CheckBoxList>

复选框列表和单选按钮列表的常用属性

属性 描述
RepeatLayout 此属性指定在呈现列表时使用表标签还是普通 HTML 流进行格式化。默认为 Table。
RepeatDirection 它指定重复控件的方向。可用的值为 Horizontal 和 Vertical。默认为 Vertical。
RepeatColumns 它指定在重复控件时使用的列数;默认为 0。

项目符号列表和编号列表

项目符号列表控件创建项目符号列表或编号列表。这些控件包含一个 ListItem 对象集合,可以通过控件的 Items 属性引用。

项目符号列表的基本语法

<asp:BulletedList ID="BulletedList1" runat="server">
</asp:BulletedList>

项目符号列表的常用属性

属性 描述
BulletStyle 此属性指定项目符号或数字的样式和外观。
RepeatDirection 它指定重复控件的方向。可用的值为 Horizontal 和 Vertical。默认为 Vertical。
RepeatColumns 它指定在重复控件时使用的列数;默认为 0。

超链接控件

超链接控件类似于 HTML <a> 元素。

超链接控件的基本语法

<asp:HyperLink ID="HyperLink1" runat="server">
   HyperLink
</asp:HyperLink>

它具有以下重要属性

属性 描述
ImageUrl 控件将显示的图像路径。
NavigateUrl 目标链接 URL。
Text 显示为链接的文本。
Target 加载链接页面的窗口或框架。

图像控件

图像控件用于在网页上显示图像,如果图像不可用,则显示替代文本。

图像控件的基本语法

<asp:Image ID="Image1" runat="server">

它具有以下重要属性

属性 描述
AlternateText 图像不存在时显示的替代文本。
ImageAlign 控件的对齐选项。
ImageUrl 控件将显示的图像路径。
广告