ExtAspNet控件库Grid控件相关属性

ExtAspNet控件库Grid控件相关属性

(2012-03-09 16:37:08)

转载▼

标签： 杂谈

分类： ExtAspNet

1、常用属性：

1.1 AllowPaging：表示是否启用分页功能；若启用分页功能，则为 true；否则为 false。默认为 false；此属性与OnPageIndexChange一起使用，当AllowPaging为false，没有翻页功能栏，即不能触发OnPageIndexChange事件；当AllowPaging为true，显示翻页功能栏，即可以触发OnPageIndexChange事件。

1.2 AllowSorting：表示是否启用排序功能；若启用排序功能，则为 true；否则为 false。默认为 false；由于Grid控件中没有SortExpression属性，因此，与OnSort事件一起使用。

1.3 BodyPadding：表示内容区域的内边距，可以设置上下左右为“5px 5px 5px 5px”。

1.4 BodyStyle：设置列头的以及Grid的样式。

例子：BodyStyle="font-weight:bold;color:red;"：设置列头为红色黑体

1.5 DataKeyNames：表示数据库绑定数据的唯一标识的属性，此值能够标识此记录，通过此值找到此记录信息，例如：此记录所在行的索引值。

1.6 EnableMultiSelect：表示可以同时勾选多条记录，true为可以，false为只能勾选一条记录，此项与EnableCheckBoxSelect共同使用。

1.7 EnableRowNumber：表示是否在显示每列的序号，true为显示，false为不显示。

1.8 EnableAjax：表示启用Ajax。

1.9 EnableAlternateRowColor：启用交替行显示不同的颜色。

1.10 EnableBackgroundColor：表示是否先背景颜色，Grid的背景颜色是白色。

1.11 EnableCheckBoxSelect：表示选择框是否能够使用并显示。

1.12 EnableCollapse：表示是否允许折叠。

1.13 EnableDelayRender：表示是否迟延渲染。

1.14 EnableHeaderMenu：表示启用标题菜单。

1.15 EnableLargeHeader：表示启用大的标题栏。

1.16 EnableLightBackgroundColor：表示是否显示浅色的背景颜色。

1.17 EnableMouseOverColor：表示启用移动到行的颜色，默认为true。

1.18 EnableViewState：表示是否启用控件的视图状态。系统默认的值为true。当设置为true时，在传递状态值时就包括该控件；如果设置为false，则传递状态值时则不包括它。

1.19 Expanded：表示是否展开，默认为true，当为true时，显示Grid相应内容，当为false时，只显示标题，其他记录信息不显示。

1.20 Height：表示Grid的高度，可用“100px”或者“100%”都可以。

1.21 hideMode:表示隐藏模式，分为Display、Offsets和Visibility三种模式，

1.22 Icon：表示预定义图标。

1.23 IconUrl：表示图标地址。

1.24 IsDatabasePaging：表示是否数据库分页；默认为false，当为true时，PageSize设置的数字不起作用，不分页，显示所有记录；当为false时，才会按照PageSize的个数进行显示相应记录。

1.25 SelectedRowIndexArrays：表示选中行，Grid.SelectedRowIndexArray.Length表示选中行的个数。

1.26 ShowBorder：表示是否显示边框。

1.27 ShowGridHeader：表示显示表格表头，默认为true。

1.28 PageIndex：表示Grid当前页序号，例如：第一页，PageIndex=0。

1.29 PageSize=” 6”：表示每页显示记录的条数，例子：显示6条记录

1.30 RowHeight：表示每一行的高度。

1.31 ShowHeader：表示显示标题（title），true为显示标题（title），false为隐藏标题（title）。

1.32 Title：表示Grid标题，与ShowHeader一起使用，ShowHeader为false时，title中的内容将不显示在界面中；当ShowHeader为true时，title中的内容将显示在界面中。

2、事件：

2.1 OnRowClick：是Grid中行点击事件，当点击一行记录，应该执行的操作；若需要触发此事件，AutoPostBack应为true。

2.2 OnPreRowDataBound：是一个事件，表示在显示绑定的数据前，可以对数据进行修饰，例如：使数据字体变为黑色等内容；若需要触发此事件，AutoPostBack应为true。

例子：通过查找ColumnID进行设置相应列的字体颜色。

protected void gr_PreRowDataBound(object sender, ExtAspNet.GridPreRowEventArgs e)

{

DataRow row = e.DataItem as DataRow;

if (row != null)

{

string style = "color:#000000;";

foreach (ExtAspNet.GridColumn column in gr.Columns)

{

ExtAspNet.LinkButtonField field = column as ExtAspNet.LinkButtonField;

if (column.ColumnID == "lb")

{

field.DataTextFormatString = "<span style="" + style + "">{0}</span>";

}

}

}

}

2.3 OnPageIndexChange：是一个事件，表示翻页功能的实现，在函数定义时，应为protected或public，不能定义private，若为private,将会界面中提示此事件函数未定义；若需要触发此事件，AutoPostBack应为true；此事件与AllowPaging属性一起使用，将AllowPaging设为true，AutoPostBack为true，才可触发此事件。

例子：

protected void gr_PageIndexChange(object sender, ExtAspNet.GridPageEventArgs e)

{

gr.PageIndex = e.NewPageIndex;

}

2.4 OnRowCommand：表示行点击事件，可以对Grid中的行内容进行点击，例如：点击一行记录，更新其他信息；也可以通过获取CommandName，执行相关操作。

例子：

protected void Grid1_RowCommand(object sender, ExtAspNet.GridCommandEventArgs e)

{

if (e.CommandName == "Action1" || e.CommandName == "Action2")

{

Alert.ShowInParent(String.Format("You click line: {0}, CommandName: {1}", e.RowIndex + 1, e.CommandName));

}

}

2.5 OnRowDataBound：表示将数据行绑定到数据时发生，将某个数据行绑定到 Grid 控件中的数据以后，将引发 RowDataBound 事件。

2.6 OnSort：表示在点击列时，进行排序。

3、包含控件：

2.1 CheckBoxField：

例子：

<ext:CheckBoxField DataField="CheckBox0" CommandName="cbxSelect" runat="server" Visible="false" ColumnId="check" />

2.2 WindowField：

例子：

<ext:WindowField Width="80%" WindowID="Window1" HeaderText="号" DataTextField="e" Title="情"

DataIFrameUrlFields=" D" IFrameUrl="~/alert.aspx" DataIFrameUrlFormatString="../asp.aspx? D={0}" ColumnId="lb" />

2.3 HyperLinkField：

例子：

<ext:HyperLinkField HeaderText="称" Target="_blank" DataTextField="e" DataTextFormatString="{0}" DataNavigateUrlFields="D"

DataNavigateUrlFormatString="../asp.aspx? D={0}"

NavigateUrl="~/alert.aspx" Width="70%" />

2.4 LinkButtonField：

例子：

<ext:LinkButtonField HeaderText="间" DataTextFormatString="{0}" DataTextField="S" CommandName="Select" Width="70%"

ColumnID="lb" />