Asp.net 简明教程
ASP.NET - Basic Controls
在本章中，将讨论 ASP.NET 中可用的基本控件。
Button Controls
ASP.NET 提供了三种类型的按钮控件：
-
Button ：它在矩形区域内显示文本。
-
Link Button ：显示看起来像超链接的文本。
-
Image Button ：它显示一张图片。
当用户单击按钮时，会触发两个事件：单击和命令。
按钮控件的基本语法：
<asp:Button ID="Button1" runat="server" onclick="Button1_Click" Text="Click" / >按钮控件的公用属性：
Property |
Description |
Text |
按钮上显示的文本。这仅适用于按钮和链接按钮控件。 |
ImageUrl |
仅适用于图像按钮控件。要为按钮显示的图像。 |
AlternateText |
仅适用于图像按钮控件。如果浏览器无法显示图像，则要显示的文本。 |
CausesValidation |
确定当用户单击按钮时是否发生页面验证。默认值为 true。 |
CommandName |
当用户单击按钮时传给命令事件的字符串值。 |
CommandArgument |
当用户单击按钮时传给命令事件的字符串值。 |
PostBackUrl |
当用户单击按钮时请求的页面的 URL。 |
Text Boxes and Labels
文本框控件通常用于接收来自用户的输入。文本框控件可以根据 TextMode 特性的设置接受一行或多行文本。
标签控件提供了一种简单的方式来显示文本，这些文本可以从一页的执行更改到另一页。如果你想显示不更改的文本，你可以使用文字文本。
文本控件的基本语法：
<asp:TextBox ID="txtstate" runat="server" ></asp:TextBox>文本框和标签的常见属性：
Property |
Description |
TextMode |
指定文本框类型。SingleLine 创建一个标准文本框，MultiLIne 创建一个接受一行以上文本的文本框，Password 导致输入的字符被屏蔽。默认值为 SingleLine。 |
Text |
文本框的文本内容。 |
MaxLength |
可以输入文本框的最大字符数。 |
Wrap |
它确定多行文本框是否自动换行；默认值为 true。 |
ReadOnly |
确定用户是否可以更改框中的文本；默认值为 false，即用户无法更改文本。 |
Columns |
文本框的宽度（以字符为单位）。实际宽度基于用于文本输入的字体而定。 |
Rows |
多行文本框的高度（以行为单位）。默认值是 0，表示单行文本框。 |
标签控件最常用的特性是“Text”，它表示在标签上显示的文本。
Check Boxes and Radio Buttons
复选框显示用户可以选中或取消选中的一个选项，而单选按钮提供一组选项，用户只能从中选择一个选项。
要创建一组单选按钮，你需要为组中每个单选按钮的 GroupName 特性指定相同名称。如果单个表单中需要多个组，则为每个组指定不同的组名。
如果你想在最初显示表单时选中复选框或单选按钮，请将其 Checked 特性设置为 true。如果组中多个单选按钮的 Checked 特性设置为 true，则只有最后一个被视为 true。
复选框的基本语法：
<asp:CheckBox ID= "chkoption" runat= "Server">
</asp:CheckBox>单选按钮的基本语法：
<asp:RadioButton ID= "rdboption" runat= "Server">
</asp: RadioButton>复选框和单选按钮的常见属性：
Property |
Description |
Text |
复选框或单选按钮旁边显示的文本。 |
Checked |
指定是否已选中，默认情况下为 false。 |
GroupName |
控件所属组的名称。 |
List Controls
ASP.NET 提供以下控件
-
Drop-down list,
-
List box,
-
Radio button list,
-
Check box list,
-
Bulleted list.
这些控件允许用户从列表中选择一个或多个项目。列表框和下拉列表包含一个或多个列表项目。这些列表可以通过代码或 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>列表框和下拉列表的公共属性：
Property |
Description |
Items |
表示控件中项目的 ListItem 对象的集合。该属性返回类型为 ListItemCollection 的对象。 |
Rows |
指定框中显示的项目数。如果实际列表包含多于显示的行，则会添加滚动条。 |
SelectedIndex |
当前所选项目的索引。如果已选择多项，则为第一个所选项目的索引。如果没有选择项目，则该属性的值为 -1。 |
SelectedValue |
当前所选项目的价值。如果已选择多项，则为第一个所选项目的价值。如果没有选择项目，则该属性的值为空字符串（“”）。 |
SelectionMode |
指示列表框允许单选还是多选。 |
每个列表项对象公用的属性：
Property |
Description |
Text |
针对该项目显示的文本。 |
Selected |
表示该项目是否已选择。 |
Value |
与该项目关联的字符串值。 |
需要注意的重要事项为：
-
若要使用下拉列表或列表框中的项目，请使用控件的 Items 属性。此属性返回一个包含列表中所有项目的 ListItemCollection 对象。
-
当用户从下拉列表或列表框中选择其它项目时，SelectedIndexChanged 事件会被激发。
The ListItemCollection
ListItemCollection 对象是 ListItem 对象的集合。每个 ListItem 对象代表了列表中的一个项目。ListItemCollection 中的项目从 0 开始编号。
如果使用字符串（如 lstcolor.Items.Add("Blue")）加载列表框中的项目，则列表项目的 Text 和 Value 属性都将被设置为您指定的字符串值。为了设置不同项目，您必须创建一个列表项目对象，然后将该项目添加到集合中。
ListItemCollection 编辑器用于向下拉列表或列表框中添加项目。这用于创建静态项目列表。若要显示集合编辑器，请从智能标记菜单中选择编辑项目，或选择控件，然后单击属性窗口中 Item 属性中的省略号按钮。
ListItemCollection 的常见属性：
Property |
Description |
Item(integer) |
表示指定索引处项目的 ListItem 对象。 |
Count |
集合中项目的数量。 |
ListItemCollection 的常见方法：
Methods |
Description |
Add(string) |
在集合末尾添加一个新项目，并将字符串参数分配给项目的 Text 属性。 |
Add(ListItem) |
在集合末尾添加一个新项目。 |
Insert(integer, string) |
在集合中指定索引位置插入一个项目，并将字符串参数分配给项目的文本属性。 |
Insert(integer, ListItem) |
在集合中指定索引位置插入该项目。 |
Remove(string) |
移除文本值与字符串相同的项目。 |
Remove(ListItem) |
Removes the specified item. |
RemoveAt(integer) |
移除指定索引（整数）处的项目。 |
Clear |
移除该集合的所有项目。 |
FindByValue(string) |
返回其值与字符串相同的项目。 |
FindByValue(Text) |
返回其文本与字符串相同的项目。 |
Radio Button list and Check Box list
单选按钮列表显示了一组互斥的选项。复选框列表显示了一组独立的选项。这些控件包含一个 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>复选框和单选按钮列表的常用属性：
Property |
Description |
RepeatLayout |
此属性指定在呈现列表时，是使用表标签还是常规 html 流程来设置格式。默认值为 Table。 |
RepeatDirection |
它指定要重复控件的方向。可用的值有水平和垂直。默认为垂直。 |
RepeatColumns |
它指定重复控件时要使用的列数；默认为 0。 |
Bulleted lists and Numbered lists
项目符号列表控件创建项目符号列表或编号列表。这些控件包含一个 ListItem 对象集合，可以通过控件的 Items 属性引用这些对象。
项目符号列表的基本语法：
<asp:BulletedList ID="BulletedList1" runat="server">
</asp:BulletedList>项目符号列表的常用属性：
Property |
Description |
BulletStyle |
此属性指定项目符号或数字的样式和外观。 |
RepeatDirection |
它指定要重复控件的方向。可用的值有水平和垂直。默认为垂直。 |
RepeatColumns |
它指定重复控件时要使用的列数；默认为 0。 |