Web服务器控件:ListItem控件

2009-03-14 23:42:39  来源:网页教学网 

WebjxCom提示:ListItem 控件可创建列表中的一个项目。

阅读此文请先查看:ASP.NET入门教程:Web服务器控件,简单讲述了Web服务器控件的使用方法。

定义和用法

ListItem 控件可创建列表中的一个项目。

此控件与这些列表控件一同使用:ASP.NET ListBox 控件 、ASP.NET RadioButtonList 控件以及ASP.NET BulletedList 控件。ListItem Web控件并不是一个独立存在的控件,它必须依附在下列几种 Web控件下:RadioButtonList Web控件、DropDownList Web控件以及CheckBoxList控件。一个ListItem Web控件代表的是一个 ListControl Web 控件的选项内容,也因为如此所以可以不需要指定 Id属性。

语法

<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="label"
Value="value" />

属性

属性 描述 .NET
Attributes 可选的。此类不直接支持的 ListItem 的属性名和值对的集合。 1.0
Enabled 可选的。规定是否禁用或启用项目。 2.0
Selected 可选的。规定是否选定该项。 1.0
Text 可选的。在 ListItem 中显示的文本。 1.0
Value 可选的。ListItem 的值。 1.0

ListControl 标准属性

AppendDataBoundItems, AutoPostBack, CausesValidation, DataTextField,
DataTextFormatString, DataValueField, Items, runat, SelectedIndex, SelectedItem,
SelectedValue, TagKey, Text, ValidationGroup, OnSelectedIndexChanged

ListControl 控件包括列表控件的所有基本功能。继承自此控件的控件包括:CheckBoxList, DropDownList, ListBox 以及 RadioButtonList 控件。

Web 控件标准属性

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, 
CssClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, 
SkinID, Style, TabIndex, ToolTip, Width

控件标准属性

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, 
EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, 
TemplateControl, TemplateSourceDirectory, UniqueID, Visible

有可能使用 Text 或 Value 属性以及 inner HTML 文本来设置显示列表项的文本。来源于webjxCom

例子

<asp:ListItem Value="Text1" Text="Text2">Text3</asp:ListItem>

根据 Text 或 Value 属性以及 inner HTML 文本的组合,可显示不同的文本,并可使用不同的值。下面的表格列出了所有可能的组合以及它们的值:

内部 HTML 内容 文本属性 值属性 呈现的“内部 HTML”内容 呈现的“值”属性
已设置 已设置 已设置 内部 HTML 内容 值属性
已设置 已设置 未设置 内部 HTML 内容 内部 HTML 内容
已设置 未设置 已设置 内部 HTML 内容 值属性
已设置 未设置 未设置 内部 HTML 内容 “内部 HTML”文本
未设置 已设置 已设置 文本属性 值属性
未设置 已设置 未设置 文本属性 文本属性
未设置 未设置 已设置 值属性 值属性
未设置 未设置 未设置 未设置 未设置

提示和注释

注释:由于 Text 和 Value 属性都具有空字符串默认值,所以列表控件中可能有空列表项。

语法

<ASP:ItemList
  Id="控件名称"
  Runat="Server"
  Selected="True | False"
  Text="选项文字"
  Value="控件标记"
/>

<ASP:ItemList
  Id="控件名称"
  Runat="Server"
Selected="True | False"
  Value="控件标记"
>
选项文字
</ASP:ItemList>

实例

<% Page Language=C#>
<Html>
<Form Id="Form1" Runat="Server">
  <ASP:RadioButtonList Id="rblA" Runat="Server">
    <ASP:ListItem Text="烤鸭" Selected="True" Value=" Duck "/>
    <ASP:ListItem Text="烤鸡" Value="Chicken"/>
  </ASP:RadioButtonList>
  <ASP:Button Id="Button1" Runat="Server" Text='确定' OnClick="Button1_Click"/>
</Form>
<ASP:Label Id="Label1" Runat="Server"/>
<Script Runat="Server">
void Button1_Click(Object Sender, EventArgs e) {
   Label1.Text="您选择了 " + rblA.SelectedItem.Text + " ,它的代号为 " + rblA.SelectedItem.Value;
}
</Script>
</Html>

更多

推荐文章