datalist
计算机领域术语
DataList控件是·NET中的一个控件。DataList控件以表的形式呈现数据，通过该控件，您可以使用不同的布局来显示数据记录，例如，将数据记录排成列或行的形式。您可以对 DataList控件进行配置，使用户能够编辑或删除表中的记录。（DataList控件不使用数据源控件的数据修改功能；您必须自己提供此代码。）DataList控件与 Repeater 控件的不同之处在于：DataList控件将项显式放在HTML表中，而Repeater控件则不然。
简介
DataList控件用于显示限制于该控件的项目的重复列表 ，其使用方式和Repeater控件相似，也是使用模板标记。不过，DataList控件会默认地在数据项目上添加表格，而且正是由于它使用模板进行设计，所以它的灵活性比GridView更高，DataList控件可被绑定到数据库表、XML文件或者其他项目列表， DataList 控件新增 SelectedItemTemplate 和 EditItemTemplate 模板标记，可以支持选取和编辑功能。
控件使用
目录
1、理解事件冒泡
2、使用模板
3、在DataList中显示数据
4、在DataList中创建多列
5、捕获DataList控件中产生的事件
6、选择DataList中的项
7、使用DataList控件中的DataKeys集合
8、编辑DataList中的项
理解事件冒泡
在“NET” 框架包含三个支持事件冒泡的标准控件：Repeater、DataList和DataGrid控件。这些控件可以让你捕获其子控件的事件。当子控件产生一个事件时，事件就“冒泡”传给包含该子控件的容器控件，并且容器控件就可以执行一个子程序来处理该事件。
使用模板
Repeater控件的五个模板（ItemTemplate、AlternationgItemTemplate、SeparatorTemplate、HeaderTemplate、FooterTemplate），可以格式化控件的输出。
在DataList控件中除了支持Repeater控件中的五个模板以外，还支持如下两个模板：
1、SelectedItemTemplate：控制如何格式化被选定的项
2、EditItemTemplate：控制如何格式化被编辑的项。
当选定DataList中选中一个项时（即DataList的SelectedIndex属性值为当前选定项的索引值），将显示SelectedItem模板，当在DataList中选择一个项来编辑（即DataList的EditItemIndex属性值为当前选定项的索引值）时，将显示EditItem模板。
在DataList中显示数据
如下程序清单演示如何显示pubs数据库中authors表中的数据：
在DataList中显示记录时，authors表中每行都显示在独立的HTML表格中，只要你愿意，也可以修改其RepeatLayout属性把DataList的项显示在HTML的中。在默认情况下，RepeatLayout属性值为Table。如果把RepeatLayout属性设为Flow，那么每个项就显示在中。
当RepeatLayout属性为Table时，通过设置GridLines属性可以在每个单元格周围显示线条。GridLines属性可选值有：Both / Horizontal / Vertical
在DataList中创建多列
DataList的一个好处的特征是可以以多个列显示数据现。通过设置其RepeatColumns和RepeatDirection属性，可以控制DataList的列的布局。
RepeatColumns属性决定要显示的列的数量。比如，如果要在DataList中显示四列的项，那么可以把这个属性设为4。
RepeatDirection属性句顶列是按水平或垂直方向来重复。在默认情况下，RepeatDirection值为Vertical，因此，如果RepeatColumns值为4，则列就像这样显示：
Column 1 Column3 Column5 Column7
Column 2 Column4 Column6 Column8
如果把RepeatDirection设为Horizontal，而且RepeatColumns值为4，那么列就像这样显示：
Column 1 Column2 Column3 Column4
Column 5 Column6 Column7 Column8
注意，即使RepeatDirection值为Vertical，还是显示为4个列。RepeatColumns永远是指重复的列的数量，而不是行的数量。
捕获DataList控件中产生的事件
DataList控件支持事件冒泡，可以捕获DataList内包含的控件产生的事件，并且通过普通的子程序处理这些事件。讲到这里有些人可能不太明白事件冒泡的好处所在，这样，我们反过来思考：如果没有事件冒泡，那么对于DataList内包含的每一个控件产生的事件都需要定义一个相应的处理函数，如果DataList中包含10000个控件呢？或者更多呢？那我们得写多少个事件处理程序。所以有了事件冒泡，不管DataList中包含多少个控件，我们只需要一个处理程序就可以了。
DataList控件支持五个事件：
(1) EditCommand：由带有CommandName=”edit”的子控件产生
(2) CancelCommand：由带有CommandName=”cancel”的子控件产生
(3) UpdateCommand：由带有CommandName=”update”的子控件产生
(4) DeleteCommand：由带有CommandName=”delete”的子控件产生
(5) ItemCommand：DataList的默认事件
有了这五个事件，那么当我点击了DataList控件中的某一个按钮的时候，应该触发哪一个事件呢？什么时候才触发它们呢？
在“ASP点NET ”中有三个控件带有CommandName属性，分别是Button、LinkButton和ImageButton，可以设置它们的CommandName属性来表示容器控件内产生的时间类型。
比如，如果设置DataList中的一个LinkButton的CommandName属性为“update”，那么点击此按钮的时候，将会触发DataList的UpdateCommand事件，我们可以将相关处理代码写到对应的事件处理程序中去。
如下程序清单演示了点击DataList中三个CommandName分别为edit、delete、update的LinkButton按钮。当点击不同的按钮时，在DataList中产生不同的事件，执行不同的程序：
在DataList中显示的三个LinkButton控件分别与相应的程序相关联。当点击名为delete的LinkButton控件的时候，就触发DataList控件DeleteCommand事件，该事件与DataList1_DeleteCommand函数相关联。
大家注意到与DataList关联的函数都带有一个DataListCommandEventArgs的参数。该阐述表示从DataList传递给该函数的信息。
DataListCommandEventArgs具有如下属性：
CommandArgument： 表示来自于产生该事件的控件的CommandArgument属性值。
CommandName： 表示产生该事件的命令名称。
CommandSource： 表示产生该事件的DataList控件。
Item： 表示来自DataList的项。就是DataList中发生事件的那一项。
选择DataList中的项
DataList控件比Repeater控件多两个模板，SelectedItemTemplate模板可以格式化DataList中被选定的项的格式。
数据绑定到DataList后，DataList中的每一项都有一个索引号，第一项的索引为0，依次往下编号。我们可以利用索引来确定DataList中具体的项。
DataList默认以ItemTemplate或ItemTemplate+AlternatingItemTemplate模板显示数据项，当DataList的SelectedIndex属性（该属性默认值为-1，表示不显示SelectedItemTemplate模板）的值为DataList某一项的索引的时候，对应的项将会以SelectedItemTemplate模板显示。
如下程序清单使用DataList来显示一列来自于Authors数据库表中的作者的姓。每个作者的姓作为一个LinkButton控件呈现。当选择一个作者时，被选定的作者就使用SelectedItemTemplate来显示。
<%@ Page Language='C#' %>
<%@ Import Namespace='System.Data.SqlClient' %>
ID=' DataList1'
OnItemCommand=' DataList1_ItemCommand'
Runat='Server'>
Text='<%#DataBinder.Eval(Container.DataItem, 'au_lname' )%>'
Runat='Server' />
<%#DataBinder.Eval(Container.DataItem, 'au_lname' )%>
上面代码中DataList1.SelectedIndex = e.Item.ItemIndex语句：表示把被选项的索引赋值给DataList控件的SelectedIndex属性。然后调用BindDataList()进行数据的重新绑定。
【研讨】
对于ItemCommand事件和DeleteCommand事件，是否每次点了CommandName为“delete”的按钮(触发DeleteCommand事件)的时候ItemCommand事件也被触发了呢？通过打开页面的Trace跟踪，在相应的事件里用Trace.Warn()方法输出。
最后得出结论：
ItemCommand事件是DataList控件产生的默认事件，任何DataList控件中CommandName为delete/cancel/update/edit的按钮被点击后，首先触发的是ItemCommand事件，然后才是相应的事件。
但是当DataList控件中存在一个普通按钮，点击后触发ItemCommand事件，假设执行功能为选择当前项，此时如果点击了CommandName为edit的按钮，将当前项显示为编辑状态。这个时候并没有出现当前行既被选中又被编辑的情形，这和以上的结论（先触发ItemCommand事件）好象相违背。事实上这并不矛盾，因为DataList控件中的项同一时刻只能显示一个EditItemTemplate或SelectedItemTemplate模板，所以执行过程应该是这样的。点击了CommandName为edit的按钮后首先触发了ItemCommand事件，将当前的项显示为SelectedItemTemplate模板，然后再触发EditCommand事件，将当前的项显示为EditItemTemplate模板，覆盖了前面已经显示的SelectedItemTemplate模板，只不过因为速度太快，肉眼看不出这个过程而已！
使用DataList控件中的DataKeys集合
在选择DataList中的一个项时，通常需要获取与这个项相关联的主键的值。可以使用DataKeys集合来获取与一个项想关联的主键的值。
假设要在DataList中显示一个名为Authors的数据库表，其中包含两个名为au_id和au_fname的列，当拥护选择DataList中的一个项时，你要提取与被选项相关联的au_id列的值，要实现这个操作，则需要设置DataList控件的DataKeyField属性：
如果把数据库表的主键类的名称赋值给DataKeyField属性，那么当绑定DataList到Authors的数据表时，一个名为DataKeys的特殊集合就自动生成了。DataKeys集合包含来自数据库表的所以的主键值，起顺序与DataList中的项相同。
注意：只有当所使用的数据表具有单个主键列时，才可以使用DataKeys集合。也就是说不能使用联合主键。
在创建了DataKeys集合后，就可以通过传递项的索引值给DataKeys集合来获取DataList中与相关项关联的主键值。比如，要获取由DataList显示的第三项的主键值，就可以是使用语句：DataList1.DataKeys[2] // DataList1为DataList控件的ID值
如果要在DataList控件的事件处理函数中发生事件的项的主键值，则可以使用语句：DataList1.DataKeys[e.Item.ItemIndex] // DataList1为DataList控件的ID值
编辑DataList中的项
DataList控件具有一个名为EditItemTemplate的模板，可以在EditItemTemplate中放置表单控件，以便能在DataList中编辑特定的项。当DataList的EditItemIndex属性（该属性默认值为-1，表示不显示EditItemTemplate模板）的值为DataList某一项的索引的时候，对应的项将会以EditItemTemplate模板显示。
注意：在DataList中一次只能有一个项被选定来编辑。
如下程序清单演示了如何编辑DataList的项，其中最主要的部分就是UpdateCommand事件的处理程序，因为DataList并不会替你处理更新数据表的操作，你必须自己编写所有的代码： <%@ Page Language='C#' %>
<%@ Import Namespace='System.Data.SqlClient' %>
ID='DataList1'
DataKeyField='au_id'
OnEditCommand='DataList1_EditCommand'
OnCancelCommand='DataList1_CancelCommand'
OnDeleteCommand='DataList1_DeleteCommand'
OnUpdateCommand='DataList1_UpdateCommand'
RepeatColumns='4'
GridLines='Both'
CellPadding='10'
EditItemStyle-BackColor='lightgrey'
Runat='Server'>
<%#DataBinder.Eval(Container.DataItem, 'au_lname' )%>
- <%#DataBinder.Eval(Container.DataItem, 'phone' )%>
Text='Edit!'
CommandName='edit'
Runat='Server' />
Last/b>
ID='txtLastName'
Text='<%#DataBinder.Eval(Container.DataItem, 'au_lname' )%>'
Runat='Server' />
Phone:
ID='txtPhone'
Text='<%#DataBinder.Eval(Container.DataItem, 'phone' )%>'
Runat='Server' />
Text='Update!'
CommandName='update'
Runat='Server' />
Text='Delete!'
CommandName='delete'
Runat='Server' />
Text='Cancel!'
CommandName='cancel'
Runat='Server' />
运行以上程序，点击其中某一项中的edit按钮的时候，将触发DataList控件的EditCommand事件，通过执行语句DataList1.EditItemIndex = e.Item.ItemIndex;将当前项显示为EditItemTemplate模板，在EditItemTemplate模板中点击cancel按钮的时候，将触发DataList控件的CancelCommand事件，通过执行语句DataList1.EditItemIndex = -1; 将当前项恢复显示为ItemTemplate模板；
当点击update按钮的时候，将触发DataList控件的UpdateCommand事件，在UpdateCommand事件的处理程序中，我们需要取得当前项对应的主键值及修改之后的值才能够完成更新，通过执行语句DataList1.DataKeys[(int)e.Item.ItemIndex].ToString();来获取当前主键值（前提是指定了DataList1的DataKeyField属性值为主键字段），由于DataKeys集合返回数据类型为object类型，我们还需要调用其ToString()方法来转换成字符串类型。通过执行语句(TextBox控件ID”）方法通过检索当前项中包含的特定ID的控件，其返回值类型为Control类型，所以还需要强制将其转换为TextBox类型，如果没有找到该ID的控件，则返回0，最后通过取得的主键值和更新后的字段的值更新数据库表。最后不要忘了重新绑定一下，否则数据库里最新的数据将不会显示出来。
（如果要在更新前对更新后的数据进行验证，则可以在EditItemTemplate模板中加入验证控件进行验证。）
HTML
定义和用法
datalist 及其选项不会被显示出来，它仅仅是合法的输入值列表。
请使用 input 元素的 list属性来绑定 datalist。
提示：不能控制 datalist 的位置，并且不能将其与服务器的数据进行绑定。
HTML4.01 与 HTML5之间的差异
全局属性
accesskey、class、contenteditable、contextmenu、data-*、draggable、dir、hidden、spellcheck、style、tabindex、title
实例
浏览器支持
目前只有 Firefox 和 Opera 支持
全国各地天气预报查询
上海市
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
云南省
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
内蒙古自治区
北京市
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
吉林省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
四川省
天津市
宁夏回族自治区
宁夏回族自治区
宁夏回族自治区
宁夏回族自治区
宁夏回族自治区
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
安徽省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山东省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
山西省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广东省
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
广西壮族自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
新疆维吾尔自治区
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江苏省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
江西省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河北省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
河南省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
浙江省
海南省
海南省
海南省
海南省
海南省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖北省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
湖南省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
甘肃省
福建省
福建省
福建省
福建省
福建省
福建省
福建省
福建省
福建省
西藏自治区
西藏自治区
西藏自治区
西藏自治区
西藏自治区
西藏自治区
西藏自治区
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
贵州省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
辽宁省
重庆市
重庆市
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
陕西省
青海省
青海省
青海省
青海省
青海省
青海省
青海省
青海省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省
黑龙江省