介绍 DataList Web 服务器控件
huerqingqing · 2005-12-05
湖儿清清水
分享彼此的难处
Updated
返回
Blog 首页
<< Web 页上显示列表的控件 得介绍(table,repeater,datalist,datagrid)
|
ASP.NET重用代码技术 - 用户控件技术 (引用) >>
DateList 学习
Time:
2005-12-05
a
ble class="bannerparthead" cellspacing="0">
Visual Basic 和 Visual C# 概念
介绍 DataList Web 服务器控件
DataList
Web 服务器控件以某种格式显示数据,这种格式可以使用模板和样式进行定义。
DataList
控件对于显示数据行很有用。可以选择将
DataList
控件配置为允许用户编辑或删除信息。还可以自定义该控件以支持其他功能,如选择行。
注意
若要精确地控制用于呈现列表的 HTML,请使用
Repeater
Web 服务器控件。如果要包括自动分页和排序功能,请使用
DataGrid
Web 服务器控件。有关更多信息,请参见
在 Web 页上显示列表的控件
。
DataList
控件将数据行显示为列表中的项。可通过包括 HTML 文本和控件,使用模板定义项的布局。例如,可以在项中使用
Label
Web 服务器控件显示数据源的字段。
下面的章节介绍
DataList
控件的功能。
将数据绑定到控件
必须将
DataList
控件绑定到数据源。
DataList
的典型数据源是数据集和数据读取器(
OleDbDataReader
或
SqlDataReader
对象)。可以使用能够从工具箱添加到页的数据源,如
DataSet
或
DataView
类。还可绑定到在代码中创建的数据源,如数据读取器或数组。控件可以将任何支持
IEnumerable
接口的类用作数据源。
当数据绑定时,可以为
DataList
控件整体指定一个数据源。在给此控件添加其他控件(例如,列表项中的标签或文本框)时,您还可以依次将它们绑定到容器,即
DataList
控件。
有关更多信息,请参见
Web 窗体页中的数据访问
。
控件布局的模板
在
DataList
控件中,使用模板定义信息的布局。
注意
有关使用模板的概述,请参见
Web 服务器控件模板
。
DataList
控件支持下列模板:
模板
说明
ItemTemplate
为数据源中的每行呈现一次的 HTML 元素和控件。
AlternatingItemTemplate
与
ItemTemplate
元素类似,但对
DataList
控件中的行每隔一行呈现一次。如果使用此模板,通常为其创建不同的外观,如与
ItemTemplate
不同的背景色。
SelectedItemTemplate
当用户选择
DataList
控件中的项时呈现的元素。典型的用法是使用背景色或字体颜色可视地标记该行。还可以通过显示数据源中的其他字段来展开该项。
EditItemTemplate
当项处于编辑模式中时的布局。此模板通常包含编辑控件,如
TextBox
控件。
HeaderTemplate
和
FooterTemplate
在列表的开始和结束处呈现的文本和控件。
SeparatorTemplate
在每项之间呈现的元素。典型的示例是行(使用 <HR> 元素)。
样式
若要在模板中指定项的外观,可以设置该模板的样式。例如,可以指定:
在白色背景上用黑色文本呈现项
在浅灰色背景上用黑色文本呈现交替项
在黄色背景上用粗体黑色文本呈现选定项
在浅蓝色背景上用黑色文本呈现正在编辑的项
每个模板支持其自己的样式对象,可以在设计时和运行时设置该样式对象的属性。
有关概述,请参见
ASP.NET 服务器控件和 CSS 样式
。
项的布局
不但可使用模板指定个别项内控件和文本的布局,而且还可以指定相对于其他项应如何布置这些项。
DataList
控件提供下列这些选项:
选项
说明
流与表
在流布局中,以字处理文档的样式在行内呈现列表项。
在表布局中,项呈现到 HTML 表中,这更便于指定项的外观,因为它使您得以设置表单元格属性,如网格线。有关详细信息,请参见
在 DataList Web 服务器控件中指定流或表格式
。
垂直与水平排序
默认情况下,在单个垂直列中显示
DataList
控件中的项。但是,可以指定该控件包含多个列。如果这样,可进一步指定这些项是垂直排序(类似于报刊栏)还是水平排列(类似于日历中的日)。有关详细信息,请参见
在 DataList Web 服务器控件中指定水平或垂直布局
。
列数
不管
DataList
控件中的项是垂直排序还是水平排序,都可指定该列表将具有多少列。这使您得以控制 Web 页的呈现宽度,通常可以因此而避免水平滚动。
事件
DataList
控件支持几种事件。这些事件之一
ItemCreated
事件提供一种在运行时自定义项的创建过程的方法。
ItemDataBound
事件也提供自定义
DataList
控件的能力,但要在数据可用于检查之后才可提供。例如,如果正使用
DataList
控件显示待办事宜列表,则可以用红色文本显示过期项,以黑色文本显示已完成项,以绿色文本显示其他任务。这两个事件都可用于重写来自模板定义的格式设置。
其余事件为了响应列表项中的按钮单击而引发。它们旨在帮助您响应
DataList
控件的最常用功能。支持该类型的四个事件:
EditCommand
DeleteCommand
UpdateCommand
CancelCommand
当用户单击某项中的按钮时,该事件会冒泡到按钮的容器:
DataList
控件。按钮引发的确切事件取决于所单击的按钮的
CommandName
属性。例如,如果按钮的
CommandName
属性为
edit
,则该按钮导致引发
EditCommand
事件。如果
CommandName
属性为
delete
,则该按钮导致引发
DeleteCommand
事件,等等。
DataList
控件还支持
ItemCommand
事件,当用户单击没有预定义的命令(如“编辑”或“删除”)的按钮时引发该事件。通过将按钮的
CommandName
属性设置为一个需要的值,然后在
ItemCommand
事件处理程序中对其进行测试,可以将该事件用于自定义功能。(例如,可以在选择某项时使用该方法,如
允许用户选择 DataList Web 服务器控件中的项
中所述。)
有关
DataList
控件支持的事件的完整列表,请参见
DataList 事件
。有关 Web 窗体事件的更多详细信息,请参见
ASP.NET 服务器控件事件模型
。
编辑和选择项
可允许用户编辑控件中的单个项。常规策略是创建
EditItemTemplate
,为编辑提供适当的布局和控件。还必须为用户提供一种方法,以指示他们要编辑项。最常用的方法是在项模板(和
AlternatingItemTemplate
,如果要使用它的话)中包括一个按钮,并将该按钮的
CommandName
属性设置为
edit
。然后,当单击该按钮时,
DataList
控件自动引发
EditCommand
事件。在该事件的事件处理程序中,将该项设置为编辑模式,编辑模式显示
EditItemTemplate
。
EditItemTemplate
通常包括允许用户保存更改或放弃更改的按钮(例如,“更新”和“取消”按钮)。这些按钮的作用类似于“编辑”按钮,它们将预定义的命令消息(“更新”或“取消”)发送到
DataList
控件,从而引发
UpdateCommand
或
CancelCommand
事件,您可以相应地响应这些事件。对于客户跟踪应用程序,该模板可能如下面的图形中所示。
使用
SelectedIndexChanged
事件选择项的过程与此类似。将按钮添加到项模板,并将其
CommandName
属性设置为
select
。然后为
SelectedIndexChanged
事件编写事件处理程序。当用户单击“选择”按钮时引发
SelectedIndexChanged
事件。有关详细信息,请参见
允许用户选择 DataList Web 服务器控件中的项
。
编辑模板模式下的 DataList
胡青波
Posted at
2005-12-05
15:47:22
Edit
|
Trackback(
0
)
原始快照:web.archive.org