DataList用法小结
DataList控件
工具箱中包括一个DataList控件。该控件可用于创建模板化的列表数据。可以在一个模板化列表中，通过设置模板来控制呈现该列表的HTML。模板描述如何显示列表中的某一项的HTML。
提示：DataList控件提供了一些简单的模板。如果需要精确控制布局，可以考虑使用Repeater控件，该控件将在下文中讲解。
在表中列出了DataList控件提供的7个不同的模板变量，它们可用来定义外观。在这些模板中，除了ItemTemplate模板外，其他都是可选的。
表 DataList控件模板
模板名 说 明
AlternatingItemTemplate 为每一个间隔项提供内容和布局。如果没有定义，在DataList中将为每一项使用ItemTemplate
EditItemTemplate 为当前正在编辑的项提供内容和布局。如果没有定义，在DataList中将为正在编辑的项使用ItemTemplate
FooterTemplate 为页脚提供内容和布局。如果没有定义，DataList将不会有页脚
HeaderTemplate 为标题提供内容和布局。如果没有定义，DataList将不会有标题行
ItemTemplate 必须定义。每一项的内容和布局的默认定义
SelectedItemTemplate 为当前选中的行提供内容和布局。如果没有定义，ItemTemplate将被使用
SeparatorTemplate 为项与项之间的分隔符提供内容和布局。如果没有定义，将不会使用分隔符
为了学习DataList控件，首先，创建一个新应用程序（WebNorthWind-DataControls）或者添加一个页面到已有的应用程序DataControls中。把DataList控件拖到表单中。在“Design”视图中，打开智能标签可以选择数据源。作为练习，选择“New Da
如果单击“Source”，将看到DataList控件已经定义了许多属性，以便识别它的数据源：
ID="DataList1"
DataKeyField="CustomerID"
DataSourceID="DataListCustomerDataSources">
图：DataList绑定数据控件
在DataList 的开闭标签之间包括一个
Text=
提示：Ev
有多种可以改善该控件外观的方法。首先，回到“Design”视图，单击“Auto Format…”，选择一个方案（如Classic），这样做将为DataList增加许多样式：
ID="DataList1"
DataKeyField="CustomerID"
DataSourceID="DataListCustomerDataSources"
CellPadding="4"
ForeColor="#333333">
...
...
另外，可以回到智能标签，选择“Edit Templates”，这将使智能标签变为“Template Editing Mode”（模板编辑模式，直到单击“End Template Editing”，该模式才结束），并提供一个下拉菜单来选择需要编辑哪个模板。
可以通过展开或者移动模板中的元素来随意修改模板、添加新的控件等。
作为替代，可以直接在内容文件中添加或者修改模板。选择何种方法由个人决定。每个模板都支持它自己的样式对象，这些对象可以在设计时设置并在运行时修改。
默认情况下，每个项是一个接着一个显示的，位于一个垂直的列中。可以通过把DataList的“Repeat Direction”属性由Vertical设置为Horizontal来修改它，也可以通过设置RepeatColumns属性来设置列的数量。
在DataList控件中，包括一些控制外观和行为的常用属性，它们并不是从Control或WebControl类继承的，如表所示。
表 未从WebControl类继承的DataList控件属性
属 性 类 型 读 写 值 说 明
Caption String × × 作为HTML caption元素显示的文本
CaptionAlign TableCaptionAlign × × Bottom、Left、NotSet、Right、Top
指定caption元素的放置位置
CellPadding Integer × × 单元格内容和边框之间的像素数
CellSpacing Integer × × 单元格之间的像素数
DataKeyField String × × 指定数据源中的键字段
DataKeys DataKeyCollection × × 每条记录的键值的集合
续表 未从WebControl类继承的DataList控件属性
属 性 类 型 读 写 值 说 明
DataMember String × × 设定多成员数据源中的数据成员
DataSource Object × × 为控件设置数据源
EditItemIndex Integer × × 编辑的行，从零开始的行索引。如果没有项被编辑或者清除对某项的选择，设置值为－1
EditItemStyle TableItemStyle × 派生自WebControl.
Style类，目前选中的编辑行的样式
FooterStyle TableItemStyle × 派生自WebControls.
Style类，页脚部分的样式属性
GridLines GridLines × × Both、Horiz- on
设置显示哪些网格线。默认值为None
HeaderStyle
TableItemStyle
×
派生自WebControls. Style类，标题部分的样式属性
Items DataListItemCollection × 控件中的所有项的集合
ItemStyle TableItemStyle × 派生自WebControls.Style 类，控件中每个项的默认样式属性
RepeatColumns Integer × × 设置显示的列数
RepeatDirection RepeatDirection × × Horizontal、Vertical 如果为Horizontal,
项是从左到右，然后从上到下显示。如果是Vertical，项是从上到下，然后从左到右显示的。默认值为Vertical
RepeatLayout RepeatLayout × × Flow、Table
如果为Flow，项显示时不会有表结构，否则会有一个表结构。默认为Table
未从WebControl类继承的DataList控件属性
属 性 类 型 读 写 值 说 明
SelectedIndex Integer × × 当前选中的项的索引，从0开始。如果没有选中任何项，或者清除对某项的选择，将值设置为－1
SelectedItem DataListItem × 返回当前选中的项
SelectedItemStyle TableItemStyle × 派生自WebCon- trols.Style类，控件中选中项的默认样式属性
SelectedValue Object × 返回当前的选中项
SeparatorStyle TableItemStyle × 派生自WebCon- trols.Style类，项与项之间的分隔符的默认样式属性
ShowFooter Boolean × × true、false是否显示页脚，默认值为true。仅当FooterTemplate不为null时有效
ShowHeader Boolean × × true、false 是否显示标题行，默认值为true。仅当HeaderTemplate属性不为null时有效
另外，DataList控件包括多个事件。表列出了其中最重要的几个事件。
表 DataList控件的事件
事 件 事件参数 事件参数属性 说 明
DataBinding EventArgs None 当控件绑定到数据源时触发（继承自Control）
DeleteCommand DataListcommand-EventArgs CommandArgument、CommandName
当单击“Delete”按钮时触发
EditCommand DataListcommand-EventArgs CommandArgument、CommandName
当单击“Edit”按钮时触发
Init EventArgs None 当控件初始化时触发（继承自Control）
续表 DataList控件的事件
事 件 事件参数 事件参数属性 说 明
ItemCommand DetailsViewCom-mandEventArgs- FormViewComm-andEventArgs
CommandArgument、CommandName、CommandSource
当单击控件中的一个按钮时触发
ItemCreated EventArgs none 在控件中的所有行创建完毕后触发
ItemDataBound DataListItemEvent-Args Item 当绑定数据时触发
PreRender EventArgs None 在控件呈现在页面上之前触发（继承自Control）
UpdateCommand DataListcommand-EventArgs CommandArgument、CommandName 当单击“Update”按钮时触发
设计模版：
页眉
页脚
数据记录
选中时的显示方式
编辑模版，里面可以嵌入控件,绑定数据。
设置外观
RepeatLayout 属性设置显示方式
RepeatDirection 显示方向
RepeatColumns 列数
事件
加入模版列的按钮会将其click事件反升到 ItemCommand 事件，也可设置CommandName 来响应不同的事件，如设为：edit,即引发EditCommand()等。
注：若设为：select 则会引发SelectedIndexChanged 和ItemCommand事件
SelectedItemTemplate模版； 添加详细信息的控件，当用户选择了该项，选择模版则显示。
private void DataList1_ItemCommand(……)
{ switch(e.CommandName)
{
case "select":
this.DataList1.SelectedIndex=e.Item.ItemIndex;
string s=(string)this.DataList1.DataKeys[e.Item.ItemIndex];
//在此获得该条记录的详细数据，在SelectedItemTemplate模版里显示。
break;
case "unselect":
this.DataList1.SelectedIndex=-1;
break;
}
this.DataList1.DataBind();//一定要
}
EditItemTemplate模版
编辑：
this.DataList1.EditItemIndex=e.Item.ItemIndex;
this.DataList1.DataBind();
更新：
得到主键
string s=(string)this.DataList1.DataKeys[e.Item.ItemIndex];
得到模版里的控件
TextBox box=(TextBox)e.Item.FindControl("TextBox1");
更新记录
this.DataList1.DataBind();
取消：
this.DataList1.EditItemIndex=-1;
this.DataList1.DataBind();
删除项
一次勾选多条记录，一次删除
foreach(DataListItem i in this.DataList1.Items)
{
bool IsChecked=((CheckBox)i.FindControl("deletectr")).Checked;
if(IsChecked)
{
string s=(string)this.DataList1.DataKeys[e.Item.ItemIndex];
删除操作 }
}
运行中自定义DataList控件
//当创建DataList控件中的任意项时
private void DataList1_ItemCreated(object sender, System.Web.UI.WebControls.DataListItemEventArgs e)
{
switch(e.Item.ItemType)
{ case ListItemType.Header:
e.Item.ForeColor=Color.Red;
e.Item.BackColor=Color.Black;
break;
case ListItemType.Item:
e.Item.BackColor=Color.Black;
break;
}
}
//当模版中的项被数据绑定时发生，数据被显示到客户端前加以访问的最后机会
private void DataList1_ItemDataBound(object sender, System.Web.UI.WebControls.DataListItemEventArgs e)
{
if((e.Item.ItemType==ListItemType.Header)||(e.Item.ItemType==ListItemType.Item))
{
System.Da
(System.Da
if((decimal)drv["库存量"]<1000)
{
e.Item.ForeColor=Color.Red;
}
}
}
另种方式
if((e.Item.ItemType==ListItemType.Header)||(e.Item.ItemType==ListItemType.Item))
{
DataRowView drv=(DataRowView)e.Item.DataItem;
string department=(string)drv["部门"];
switch(department)
{ case "销售部":
e.Item.BackColor=Color.Black;
break;
case "技术部":
e.Item.BackColor=Color.Red;
break; }
}
