kj08-03-01.txt

asp.net(适用于高职高专教学)电子教案

8.3.1  DataList控件的属性和事件
DataList控件的属性和事件相当多，对初学者而言，不必也不可能在短时间内将这些属性和事件完全记住。学习这些属性和事件的最有效的途径就是多剖析一些实例的源码。本书在此对属性和事件进行条列的目的主要便于读者在需要时查阅。
8.3.1.1  DataList控件的属性
DataList控件的属性如下：
* HeaderStyle：给出或设置页眉模板的显示样式，其属性来自TableItemStyle类。
* HeaderTemplate：页眉模板，用来定义DataList控件的标题，它会在所有数据显示出来前，显示在数据的最前面，其显示样式由HeaderStyle属性决定，该模板可省略不写。
* ItemTemplate：数据模板，用来定义奇数行记录的显示格式，其显示样式由ItemStyle决定，该模板为必要模板。
* ItemStyle：给出或设置数据模板的显示样式，其属性来自TableItemStyle类。
* AlternatingItemTemplate：偶数行数据模板，用来定义偶数行记录的显示格式。如果省略偶数行数据模板，则全部数据均将按奇数行数据模板显示。
* AlternatingItemStyle：获取或设置偶数行数据模板的显示样式，其属性来自TableItemStyle类。
* EditItemTemplate：编辑模板，用来定义数据处于编辑模式时的显示格式，该模板可省略不写。
* EditItemStyle：给出或设置编辑模板的显示样式，其属性来自TableItemStyle类。
* SelectedItemTemplate：选取模板，用来定义被选择数据行的显示格式，该模板可省略不写。
* SelectedItemStyle：给出或设置选取模板的显示样式，其属性来自TableItemStyle类。
* SeparatorTemplate：分隔模板，用于指定如何分隔记录行。此模板可省略不写。
* SeparatorStyle：给出或设置分隔模板的显示样式，其属性来自TableItemStyle类。
* FooterTemplate：页脚模板，用来定义DataList控件页脚内容，页脚内容会在所有数据都显示出来后，显示在数据的最后面，其显示样式由FooterStyle决定，该模板可省略不写。
* FooterStyle：给出或设置页脚模板的显示样式，其属性来自TableItemStyle类。
* CellPadding="n"：给出或设置单元格边框与内容的距离，单位为像素。
* CellSpacing="n"：给出或设置单元格之间的距离，单位为像素。
* DataKeyField="…"：给出或设置关键字段的名称。每条记录的关键字段内容均存放在DataKeyCollection中，例如DataKeyField="学号"表示要将每条记录的“学号”字段内容存放在DataKeyCollection中。该属性通常用于构造SQL语句。
* DataKeys：给出DataKeyCollection，其包含的字段内容是由DataKeyField属性指定的。可以利用DataKeys来访问DataKeyField属性指定的关键字段内容，例如DataKeys.Count可以给出记录总数，DataKeys.Item(x)可以给出第x+1条记录中关键字段内容。
* DataMember="…"：给出或设置数据表名称。此数据表会连接到DataList控件，当内存数据库包含多个数据表时，就必须为DataList控件设置该属性。
* Datasource="…"：给出或设置与DataList控件绑定的内存数据库。
* EditItemIndex="n"：给出或设置编辑项目的下标，在没有编辑数据的状态下，EditItemIndex属性为-1，换言之，通过对该属性进行设置，可以决定哪条数据应该进入编辑模式，欲离开编辑模式，只需将该属性设置为-1即可。
* ExtractTemplateRows="True | False"：给出或设置当模板包含Table控件（<ASP：Table>）时，是否打散所有Table控件再重新组合。默认为False，表示当模板包含Table控件时，在执行结果中每条数据都将被放入一个独立的表格中；若ExtractTemplateRows属性为True，则DataList控件将生成一个新的表格，然后将所有数据放入该表格中，而每条数据都占据一个单独的表格行。需要指出的是，当ExtractTemplateRows属性为True时，所用模板都必须包括结构完整的Table控件，否则会产生错误。
* Gridlines="None | Horizontal | Vertical | Both"：给出或设置当DataList控件的RepeatLayout属性为Table时，DataList控件的网格线样式（无、水平网格线、垂直网格线、水平网及垂直网格线），默认为None。
* HorizontalAlign="NotSet | Left | Center | Right"：给出或设置DataList控件的水平对齐方式（无设置、居左、居中、居右）。
* Items：给出DataListItemCollection。DataListItemCollection有两个较重要的属性：其中Count属性可给出DataList控件所包含的记录数；Item(x)则可给出下标为x的DataListItem对象。
* RepeatColumns="n"：给出或设置DataLis控件显示的栏数，默认为0（表示无设置）。
* RepeaterDirection="Vertical | Horizontal"：给出或设置DataLis控件显示的方向（垂直，水平），默认为Vertical。
* RepeatLayout="Flow | Table"：给出或设置DataLis控件的配置方式（非表格型态，表格型态），默认为Table。
* SelectedIndex="n"：给出或设置选取数据行的下标，如果没有选取任何数据行，则SelectedIndex属性为-1，通过控制SelectedIndex属性可以决定选取哪条数据，欲放弃选取数据，只需将SelectedIndex属性设为-1即可。
* SelectedItem：返回目前选取的Datalist对象（数据行）。
* ShowFooter="True | False"：给出或设置是否显示页脚模板所指定的内容，默认为True。
* ShowHeader="True | False"：给出或设置是否显示页眉模板所指定的内容，默认为True。
8.3.1.2  DataList控件的事件
DataList控件的事件定义如下：
* OnEditCommand="…"：当单击DataList控件的“编辑”按钮时会触发此事件，“编辑”按钮指的是CommandName属性为“Edit”的Button、ImageButton或LinkButton控件，参数为DataListCommandEventArgs。其中参数的CommandArgument用于获取按钮控件所指定的选择性参数；CommandName用于获取按钮控件所指定的命令名称；CommandSource用于获取按钮控件对象；Item用于获取按钮控件所在的DataList对象。
* OnUpdateCommand="…"：当选取DataList控件的“更新”按钮时会触发此事件，“更新”按钮指的是CommandName属性为“Update”的Button、ImageButton或LinkButton控件，参数为DataListCommandEventArgs。
* OnDeleteCommand="…"：当单击DataList控件的“删除”按钮时会触发此事件，“删除”按钮指的是CommandName属性为“Delete”的Button、ImageButton或LinkButton控件，参数为DataListCommandEventArgs。
* OnCancelCommand="…"：当单击DataList控件的“取消”按钮时会触发此事件，“取消”按钮指的是CommandName属性为“Cancel”的Button、ImageButton或LinkButton控件，参数为DataListCommandEventArgs。
* OnItemCommand="…"：当单击DataList控件的Button、ImageButton或LinkButton控件时会触发此事件，其参数也是DataListCommandEventArgs。
* OnItemCreated="…"：当在DataList控件中创建数据时会触发此事件，参数为DataListitemEventArgs，其Item属性可给出与此事件相关的数据行（DataListItem）对象。
* OnItemDataBound="…"：当数据项连接到DataList控件但尚未显示出来前会触发此事件，参数为DataListitemEventArgs，其Item属性可给出与此事件相关的数据行（DataLisItem对象）。
* OnSeletedIndexChanged="…"：当选取的项目改变时会触发此事件。
8.3.1.3  TableItemStyle类
HeaderStyle、ItemStyle、AlternatingItemStyle、SeparatorStyle、EditItemStyle、SelectedItemStyle及FooterStyle样式对象的属性均来自TableItemStyle类，其属性如下：
* BackColor="#RRGGBB"：给出或设置背景颜色。
* BorderColor="#RRGGBB"：给出或设置边框颜色。
* BorderStyle="NotSet | None | Dotted | Dashed | Solid | Double | Groove | Ridge | Inset | OutSet"：给出或设置边框类型。
* BorderWidth="n"：给出或设置边框宽度，单位为px（像素）、pt（点）、pc（1/6英寸）、in（英寸）、mm（毫米）、cm（厘米）或%（窗口缩放百分比）等，默认单位为px。
* CssClass="…"：给出或设置CSS样式类型。
* Font：给出或设置字体信息，其子属性有Bold（粗体）、Italic（斜体）、Name（字体名称）、Names（字体名称清单）、Overline（上划线）、Size（字号）、Strikeout（删除线）、Underline（下划线）。
* ForeColor="#RRGGBB"：给出或设置前景颜色，即字体颜色。
* Height="n"：给出或设置对象的高度，单位为px或%，默认为px。
* HorizontalAlign="Center | Justify | Left | Notset | Right"：给出或设置单元格内容的水平对齐方式（居中对齐、左右对齐、左对齐、无设置、右对齐），默认值为Notset。
* VerticalAlign="Bottom | Middle | NotSet | Top"：给出或设置单元格内容的垂直对齐方式（底端、中央、无设置、顶端），默认值为Notset。
* Width="n"：给出或设置对象的宽度，单位为px（像素）、pt（点）、pc（1/6英寸）、in（英寸）、mm（毫米）、cm（厘米）或%（窗口缩放百分比）等，默认为px。
* Wrap="True | False"：给出或设置单元格内容长度超过单元格宽度时是否自动换行，默认为True。