kj08-04-01.txt

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

8.4.1  自动生成字段的DataGrid控件
可自动产生字段的DataGrid控件的声明语法如下：
<ASP:DataGrid Runat="Server" Id="…" DataSource='<%# … %>' 
AllowPaging="True | False" AllowSorting="True | False"
AutoGenerateColumns="True" BackImageUrl="URL" CellPadding="n" CellSpacing="n" 
DataKeyField="…" GridLines="None | Horizontal | Vertical | Both"
HorizontalAlign="Center |Justify | Left | NotSet | Right" PageSize="n"
ShowFooter="True | False" ShowHeader="…" OnItemCreated="…" 
OnpageIndexChanged="…" OnSortCommand="…" … >
  <HeaderStyle BorderColor="…" … />
  <ItemStyle Font-Bold="True|False" … />
  <AlternatingItemStyle ForeColor="…" … />
  <SeparatorStyle BackColor="…" … />
  <FooterStyle BorderColor="…" … />
  <PagerStyle BorderColor="…" … />
</ASP:DataGrid>
将DataGrid控件AutoGenerateColumns属性设为True，则控件将自动决定显示哪些字段。这种方式一般只用于浏览数据库记录。
在自动产生字段方式下，DataGrid控件的主要属性如下：
* AllowCustomPaging="True | False"：给出或设置是否启用自定义分页功能，默认为False。在关闭自定义分页功能时，每遇到换页，DataGrid控件都会重新加载数据源中的数据，如果数据量很大，分页浏览将会浪费大量系统资源。在启用自定义分页功能后，每逢换页，DataGrid控件都只加载该分页所须的数据，这样可节省系统资源。欲启用自定义分页功能，必须将AllowPaging及AllowCustomPaging两个属性设置为True，且VirtualItemCount属性设置为DataGrid控件所要包含的数据条数，同时SQL命令必须能从数据源中给出单一分页所需的数据条数。
* AllowPaging="True | False"：给出或设置是否启用分页功能，默认为False。
* AllowSorting="True | False"：给出或设置是否启用排序功能，默认为False。
* AlternatingItemStyle：给出或设置偶数行记录的显示格式，其属性来自TableItemStyle类。
* AutoGeneraterColumns="True | False"：给出或设置是否自动生成并显示字段数据，默认为True。
* BackImageUrl="URL"：给出或设置DataGrid控件背景图片的相对或绝对地址，若设置的图片比DataGrid控件小，则图片会自动放大以适应DataGrid控件。
* CellPadding="n"：给出或设置单元格边框与内容的距离，n为像素数。
* CellSpacing="n"：给出或设置单元格之间的距离，n为像素数。
* CurrentPageIndex="n"：给出或设置目前显示页的下标，配合OnPageIndexChanged事件来变更此属性，可以达到换页的目的。
* DataKeyField="…"：给出或设置关键字段的名称。每条记录的关键字段内容均存放在DataKeyCollection中，例如DataKeyField="学号"表示要将每条记录的“学号”字段内容存放在DataKeyCollection中。该属性通常用于构造SQL语句。
* DataKeys：给出DataKeyCollection，其包含的字段内容是由DataKeyField属性指定的。可以利用DataKeys来访问DataKeyField属性指定的关键字段内容，例如DataKeys.Count可以给出记录总数，DataKeys.Item(x)可以给出第x+1条记录中关键字段内容。
* DataMember="…"：给出或设置数据表名称。此数据表会连接到DataGrid控件，当内存数据库包含多个数据表时，就必须为DataGrid控件设置该属性。
* Datasource="…"：给出或设置与DataGrid控件绑定的内存数据库。
* FooterStyle：给出或设置页脚内容的显示样式，其属性来自TableItemStyle类。
* GridLines="None | Horizontal | Vertical | Both"：给出或设置DataGrid控件的网络线样式（无、水平线、垂直线、水平及垂直线），默认为Both。
* HeaderStyle：给出或设置标题行的显示样式，其属性来自TableItemStyle类别。
* HorizontalAlign="NotSet | Left | Center | Right"：给出或设置DataGrid控件的水平对齐方式（无设置、居左、居中、居右）。
* Items：给出DataGridItemCollection。DataGridItemCollection有两个较重要的属性，其中Count属性可给出DataGrid控件所包含的记录数；Item(x)则可给出下标为x的DataGridItem对象。
* ItemStyle：给出或设置奇数行记录的显示样式，其属性来自TableItemStyle类。
* PageCount：给出DataGrid控件的页数，页数（PageCount属性）等于总记录数与每页显示记录数（由PageSize属性指定）的比值。
* PagerStyle：给出或设置页码区的显示格式，除来自TableItemStyle类的属性外，PagerStyle还有如表8-4-1所示的属性。
* PageSize="n"：给出或设置每页显示的记录数，默认为10，该属性只在AllowPaging属性为True时有效。
* SelectedIndex="n"：给出或设置所选项目的下标，若没有选取任何记录，则SelectedIndex属性为-1，通过控制SelectedIndex属性可以决定选择哪条记录，欲放弃选择，可将SelectedIndex设为-1。
* SelectedItem：返回所选的DataGridItem（数据行）对象。
* SelectedItemStyle：给出或设置所选择记录的显示样式，其属性来自TableItemStyle类。
* Showfooter="True | False"：给出或设置是否显示Datagrid控件的页脚，默认为False。
* ShowHeader="True | False"：给出或设置是否显示Datagrid控件的页眉，默认为True。
PageStyle的其他属性
属性
描述
Mode
给出或设置页码的显示格式。属性值有NextPrev（显示指向上页和下页的超涟接）及NumericPages（显示页码）
NextPageText
给出或设置“下页”锚标。可包含HTML标记。例如<B>下一页</B>。甚至可以搭配<Img>标记使用，让前往下页的按钮以图片显示，默认为&gt;，表示显示符号“>”。此属性只在Mode属性为NumericPages时有意义。
PrevPageText
给出或设置“上页”锚标。可包含HTML标记。例如<B>上一页</B>。甚至可以搭配<Img>标记使用，让前往上页的按钮以图片显示，默认为&lt;，表示显示符号“<”。此属性只在Mode属性为NumericPages时有意义。
PageButtonCount
给出或设置分页区最多显示多少个页码，例如DataGrid控件共有10页，PageButtonCount属性为5，则只显示5个页码，页码区会出现类似"...3 4 5 6 7..."的结果，超出的部分会以“...”取代，单击“...”可显示前后页码。此属性只在Mode属性为NumericPages时有效。
Position
给出或设置分页区的显示位置。属性值可为Bottom（底端）、Top（顶端）、TopAndBottom（顶端及底端），默认为Bottom。
Visible
给出或设置是否显示分页区，默认为True。
在自动产生字段方式下，DataGrid控件的主要事件如下：
* OnItemCreated="…"：当在DataGrid控件中创建数据时会触发此事件，参数为DataGridItemEventArgs，其Item属性可以给出与此事件相关的数据行（DataGridItem）对象。
* OnPageIndexChanged="…"：当单击分页区中的页码时会触发此事件，参数为DataGridPageChangedEventArgs，其NewPageIndex属性可以给出新页码。
* 	OnSelectedIndexChanged="…"：当选取的记录行改变时会触发此事件。
* OnSortCommand="…"：当用户点击排序按钮时会触发此事件，其参数为DataGridSortCommandEventArgs，其SortExpession属性可获取用户指定的排序字段名。