1. GridView控件的事件
GridView有很多事件，事件可以定制控件的外观或者行为。事件分为三类
1.1 GridView显示数据时的事件
● DataBinding : 在绑定数据源之前触发 [继承自Control]
● DataBound 在绑定到数据源后触发
● RowCreated 创建每一行时触发
● RowDataBound : 每一行绑定完数据时触发
MSDN解释：呈现 GridView 控件之前，必须先为该控件中的每一行创建一个 GridViewRow 对象。在创建 GridView 控件中的每一行时，将引发 RowCreated 事件。这使您可以提供一个这样的事件处理方法，即每次发生此事件时就执行一个自定义例
程（如在行中添加自定义内容）。
例1：使用 RowCreated 事件将正在创建的行的索引存储在该行所包含 LinkButton 控件的 CommandArgument 属性中
Code
<script runat="server">
protected void GridView2_RowCommand(object sender, GridViewCommandEventArgs e)
{
if(e.CommandName=="Add")
{
int index = Convert.ToInt32(e.CommandArgument);
GridViewRow gvRow = GridView2.Rows[index];
ListItem item = new ListItem(); // 创建ListItem项
item.Text = Server.HtmlDecode(gvRow.Cells[2].Text);
if(!ListBox1.Items.Contains(item)) //如果还没有包含该项
{
ListBox1.Items.Add(item);
}
}
}
protected void GridView2_RowCreated(object sender, GridViewRowEventArgs e)
{
if(e.Row.RowType == DataControlRowType.DataRow)
{
// 获得第一列的LinkButton控件对象
LinkButton addLink = (LinkButton)e.Row.Cells[0].Controls[0];
// 给Link控件CommandArgmenut参数赋值，值为当前的索引
addLink.CommandArgument = e.Row.RowIndex.ToString();
}
}
</script>
<asp:GridView ID="GridView2" runat="server" AllowPaging="True" AutoGenerateColumns="False" PageIndex="10"
onrowcommand="GridView2_RowCommand" onrowcreated="GridView2_RowCreated">
<Columns>
<asp:ButtonField ButtonType="Link" CommandName="Add" Text="Add" />
<asp:BoundField DataField="Id" SortExpression="Id" HeaderText="编号" />
<asp:BoundField DataField="Description" HeaderText="描述" />
</Columns>
<PagerSettings Mode="NumericFirstLast" Position="Bottom" />
<PagerStyle HorizontalAlign="Center" />
</asp:GridView>
<asp:ListBox ID="ListBox1" runat="server"></asp:ListBox>
例2：使用 RowDataBound 事件在数据源中的字段值显示在 GridView 控件中之前修改该值。
Code
protected void GridView2_RowDataBound(object sender, GridViewRowEventArgs e)
{
if(e.Row.RowType==DataControlRowType.DataRow)
{
e.Row.Cells[2].Text = "<i>" + e.Row.Cells[2].Text + "</i>";
// 也可以使用DataBinder.Eval取得相应Cell内的值
decimal boxOfficeTotal = (decimal)DataBinder.Eval(e.Row.DataItem,”BoxOfficeTotals”);
if(boxOfficeTotal > 20000)
e.Row.BackColor = System.Drawing.Color.Yellow;
}
}
以上，在RowCreated,RowDataBound事件中，都有一个参数为GridViewRowEventArgs的对象，通过该对象，可以访问相应的GridViewRow对象。
【而GridViewRow对象的一些东西，在下面会单独来讲述。】
● RowCommand 当GridView中的控件引发事件时触发
RowCommand触发时，有一个参数GridViewCommandEventArgs对象，通过它，可以知道CommandName，CommandArgument，见例11
● RowUpdating 当GridView更新记录前触发
RowUpdating 事件发生时，有一个参数为GridViewUpdateEventArgs的对象,其有一些属性有用处
▲ Cancel : 应取消事件，则为 true；否则为 false
▲ Keys : 包含已更新记录的键字段名称/值对的字典
▲ NewValues：包含已更新记录的新字段的名称/值对的字典
▲ OldValues：包含被更新记录的原始字段名称/值对的字典
▲ RowIndex: 所更新的行的索引
● RowUpdated 当GridView更新记录后触发
RowUpdated事件发生时，有一个参数为GridViewUpdatedEventArgs的对象。其有一些属性在更新时很有用处
▲ AffectedRows: 受更新操作影响的行数
▲ Exception : 更新操作过程中引发的异常。如果未引发异常，此属性将返回 null
▲ ExceptionHandled:异常已在事件处理程序中得到处理，则为 true，异常不会被再次引发；否则为 false
▲ KeepInEditMode:如果在完成更新操作之后该控件继续处于编辑模式，则为 true；否则为 false
▲ Keys : 包含已更新记录的键字段名称/值对的字典
▲ NewValues：包含已更新记录的新字段的名称/值对的字典
▲ OldValues：包含被更新记录的原始字段名称/值对的字典
注意与RowUpdating事件发生时，事件参数类的区别
● RowDeleting 当GridView删除记录前触发
RowDeleting事件发生时，有一个参数为GridViewDeleteEventArgs的对象，其有一些属性
▲ Cancel、Keys、RowIndex、Values
以上，Values获取包含要删除的行的非键字段名称/值对的字典。其它的与RowUpdting时参数对象用法大同小异
● RowDeleted 当GridView删除记录后触发
RowDeleted事件发生时，有一个参数为GridViewDeletedEventArgs的对象，其有一些属性
▲ AffectedRows、Exception 、ExceptionHandled、Keys、Values，见RowUpdated时参数的用法
● RowCancelingEdit: 取消更新记录后触发
单击编辑模式中某一行的“取消”按钮以后，将引发 RowCancelingEdit 事件，但在该行退出编辑模式之前。
这使您可以提供一个这样的事件处理方法，例如，如果取消操作将行置于不希望有的状态，则停止该操作。
RowCancelingEdit发生时，有一个名为GridViewCancelEditEventArgs对象的参数，包含两个属性：Cancel和RowIndex.
● RowEditing : 单击某一行的“编辑”按钮以后， GridView 控件进入编辑模式之前触发。
这使您可以提供一个这样的事件处理方法，即每次发生此事件时就执行一个自定义例程（如取消编辑操作，不出现Edit框）。
RowEditing事件发生时，有一个参数为GridViewEditEventArgs对象，它包括以下二个属性
▲ Cancel : 是否编辑事件
▲ NewEditIndex: 所编辑的行的索引。
例3：如何访问已更新记录的非键字段的原始值。
Code
<script runat="server">
void CustomersGridView_RowUpdated(Object sender, GridViewUpdatedEventArgs e)
{
if (e.Exception == null) { // 如果更新没有异常
if (e.AffectedRows == 1) { // 如果影响行数为1行
//使用Keys属性可以访问键字段名称/值，需要在GridView中设定DataKeyNames
String keyFieldValue = e.Keys["CustomerID"].ToString();
Message.Text = "Record " + keyFieldValue + " updated successfully. ";
// 显示新的和原有的旧的字段值,OrderedDictionary类表示键或索引可访问的键/值对的集合。
DisplayValues((OrderedDictionary)e.NewValues, (OrderedDictionary)e.OldValues);
}
else { //如果影响行数为多行
Message.Text = "An error occurred during the update operation.";
e.KeepInEditMode = true;
}
}
else { // 有异常发生
Message.Text = e.Exception.Message;
// Use the ExceptionHandled property to indicate that the exception is already handled.
e.ExceptionHandled = true;
e.KeepInEditMode = true;
}
}
// 显示OrderedDirctionary中的键/值对
void DisplayValues(OrderedDictionary newValues, OrderedDictionary oldValues)
{
Message.Text += "<br/></br>";.
for (int i = 0; i < oldValues.Count; i++) {
Message.Text += "Old Value=" + oldValues[i].ToString() +
", New Value=" + newValues[i].ToString() + "<br/>";
}
Message.Text += "</br>";
}
</script>
<asp:gridview id="CustomersGridView" datasourceid="CustomersSqlDataSource"
autogeneratecolumns="true" autogenerateeditbutton="true" allowpaging="true"
datakeynames="CustomerID" onrowupdated="CustomersGridView_RowUpdated"
runat="server">
</asp:gridview>
例4：控件中移除最后一条记录时，如何使用 RowDeleting 事件取消删除操作。
Code
<script runat="server">
void CustomersGridView_RowDeleting(Object sender, GridViewDeleteEventArgs e)
{
// Cancel the delete operation if the user attempts to remove
// the last record from the GridView control.
if (CustomersGridView.Rows.Count <= 1)
{
e.Cancel = true;
Message.Text = "You must keep at least one record.";
}
}
</script>
1.3 GridView选择、排序和分布事件
● PageIndexChanging: 击某一页导航按钮时，但在 GridView 控件处理分页操作之前发生。
PageIndexChanging事件发生时，事件处理函数中会有一个GridViewPageEventArgs 对象的参数，该对象包含以下属性：
▲ Cancel : 获取或设置指示是否应取消事件的值
▲ NewPageIndex : 获取或设置要在 GridView 控件中显示的新页的索引。
● PageIndexChanged : 单击某一页导航按钮时，但在 GridView 控件处理分页操作之后发生。
PageIndexChanged事件发生时，相应的参数是普通的EventArgs对象。
● Sorting : 在排序开始前触发
事件发生时，会传递GridViewSortEventArgs对象参数，该对象包含以下属性
▲ Cancel : 获取或设置指示是否应取消排序
▲ SortDirection: 获取或设置排序方向。
▲ SortExpression: 获取或设置指控件中的项进行排序的表达式。
● Sorted: 排序操作进行处理之后触发
事件发生时，相应的参数是普通的EventArgs对象。
● SelectedIndexChanging : 行被选中之前发生。
事件发生时，会传递GridViewSelectEventHandler 对象参数，该对象包含以下属性
▲ Cancel : 获取或设置指示是否应取消选择
▲ NewSelectedIndex: 获取或设置要在 GridView 控件中选择的新行的索引
● SelectedIndexChanged : 行被选中之后发生。
事件发生时，相应的参数是普通的EventArgs对象。
注：在这个事件中，可以直接访问GridView.SelectedRow,以取得被选中的GridViewRow对象
例5：如何使用 NewPageIndex 属性确定用户所选择页面的索引。
Code
<script runat="server">
void CustomersGridView_PageIndexChanging(Object sender, GridViewPageEventArgs e)
{
if (CustomersGridView.EditIndex != -1) {
// 如果正处在编辑模式，不进行分页
e.Cancel = true;
int newPageNumber = e.NewPageIndex + 1;
Message.Text = "Please update the record before moving to page " +
newPageNumber.ToString() + ".";
}
else {
Message.Text = ""; // Clear the error message.
}
}
void CustomersGridView_RowCancelingEdit(Object sender, GridViewCancelEditEventArgs e)
{
// Clear the error message.
Message.Text = "";
}
</script>
例6: 如何使用 SortExpression 属性确定正在对哪一列进行排序。如果对地址列进行排序，排序操作将被取消。
Code
<script runat="server">
void CustomersGridView_Sorting(Object sender, GridViewSortEventArgs e)
{
if (e.SortExpression == "Address") {
e.Cancel = true;
Message.Text = "You cannot sort by address.";
SortInformationLabel.Text = "";
} else{
Message.Text = "";
}
}
void CustomersGridView_Sorted(Object sender, EventArgs e)
{
// Display the sort expression and sort direction.
SortInformationLabel.Text = "Sorting by " +
CustomersGridView.SortExpression.ToString() +
" in " + CustomersGridView.SortDirection.ToString() +
" order.";
}
</script>
2. GridViewRow对象
GridView 控件将其所有数据行都存储在 Rows 集合中。若要确定 Rows 集合中 GridViewRow 对象的索引，请使用 RowIndex 属性。
对于WEB来说，一个GridViewRow，其实就相当于一个<tr></tr>行
2.1 GridViewRow的类型(RowType)
用于表示 GridView 控件中的单独行。GridView 控件中的每个行都有指定的行类型。下表列出了各种行类型。
● DataGridRowType.DataRow : 数据行
● DataGridRowType.Footer : 脚注行
● DataGridRowType.Header : 标头行
● DataGridRowType.NullRow : 空行，没有数据显示时，控件中将显示空行
● DataGridRowType.Pager : 页导航
● DataGridRowType.Separator : 分隔符行
如果要确定GridViewRow对象的类型，请使用RowType属性
2.2 GridViewRow的状态(RowState)
● DataControlRowState.Alternate : 备用行状态
● DataControlRowState.Edit : 行处于编辑状态
● DataControlRowState.Normal : 行处于正常状态
● DataControlRowState.Selected : 已选定GridViewRow对象
若要确定 GridViewRow 对象的状态，请使用 RowState 属性。
2.3 DataItem,Cells属性
● DataItem : GridViewRow 对象绑定到的基础数据对象。该属性只在发生 GridView 控件的 RowDataBound 事件时及在发生后才可用。
例7: 如何使用 DataItem 属性检索字段值。将该值用于预先选择在某一行处于编辑模式时显示的 DropDownList 控件中的某个项。
Code
<script runat="server">
void AuthorsGridView_RowDataBound (Object sender, GridViewRowEventArgs e)
{
// 是否处于编辑模式
if(e.Row.RowState == DataControlRowState.Edit) {
DataRowView rowView = (DataRowView)e.Row.DataItem; // 获得编辑行的DataRowView对象
String state = rowView["state"].ToString(); // 通过DataRowView，可以直接取出某字段
DropDownList list = (DropDownList)e.Row.FindControl("StatesList"); // 获得StatesList的DropDownList对象
ListItem item = list.Items.FindByText(state); // 找到DropDonList中的某一项
list.SelectedIndex = list.Items.IndexOf(item); // 选中那一项
}
}
void AuthorsGridView_RowUpdating(Object sender, GridViewUpdateEventArgs e)
{
GridViewRow row = AuthorsGridView.Rows[AuthorsGridView.EditIndex];
// Retrieve the DropDownList control from the row.
DropDownList list = (DropDownList)row.FindControl("StatesList");
e.NewValues["state"] = list.SelectedValue;
}
</script>
<asp:gridview id="AuthorsGridView" datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="false" autogenerateeditbutton="true" datakeynames="au_id"
onrowdatabound="AuthorsGridView_RowDataBound"
onrowupdating="AuthorsGridView_RowUpdating" runat="server">
<columns>
<asp:boundfield datafield="au_lname" headertext="Last Name"/>
<asp:boundfield datafield="au_fname" headertext="First Name"/>
<asp:templatefield headertext="State">
<itemtemplate> <%#Eval("state")%> </itemtemplate>
<edititemtemplate>
<asp:dropdownlist id="StatesList" datasourceid="StatesSqlDataSource"
datatextfield="state" runat="server"/>
<asp:sqldatasource id="StatesSqlDataSource" <!-- 在GridView模板中也可以加入SqlDataSource控件 -->
selectcommand="SELECT Distinct [state] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server"> </asp:sqldatasource>
</edititemtemplate>
</asp:templatefield>
</columns>
</asp:gridview>
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_id], [au_lname], [au_fname], [state] FROM [authors]"
updatecommand="UPDATE authors SET [au_lname]=@au_lname, [au_fname]=@au_fname, [state]=@state WHERE au_id=@au_id"
connectionstring="server=localhost;database=pubs;integrated security=SSPI" runat="server">
</asp:sqldatasource>
● Cells属性: 通过使用 Cells 属性，可以访问 GridViewRow 对象的单独单元格.
如果某个单元格包含其他控件，则通过使用单元格的 Controls 集合，可以从单元格检索控件。
如果某列是BoundField字段，可以使使用Cells[].Text属性。
【注:在 TemplateField 字段列中可以直接使用数据绑定表达式，无需将值绑定到控件的某个属性。在这种情况下，字段值将自动放置在 DataBoundLiteralControl 控件中。若要检索字段值，必须先从相应单元格检索 DataBoundLiteralControl 控件，然后再使用其 Text 属性。例如:】
void AuthorsGridView_SelectedIndexChanged(Object sender, EventArgs e) {
String lastName = selectRow.Cells[ 1 ].Text; // 针对BoundField字段
DataBoundLiteralControl firstNameLiteral = (DataBoundLiteralControl)selectRow.Cells[ 2 ].Controls[ 0 ]; // 针对TemplateField字段
String firstName = firstNameLiteral.Text;
}
</ script >
< asp:gridview id ="AuthorsGridView" datasourceid ="AuthorsSqlDataSource"
autogeneratecolumns ="false" autogenerateselectbutton ="true"
onselectedindexchanged ="AuthorsGridView_SelectedIndexChanged" runat ="server" >
< columns >
< asp:boundfield datafield ="au_lname" headertext ="Last Name" />
< asp:templatefield headertext ="FirstName" >
< itemtemplate > <% # Eval ( " au_fname " ) %> </ itemtemplate >
</ asp:templatefield >
</ columns >
</ asp:gridview >
2.4 其它一些属性
GridViewRow有很多属性，具体可以参考MSDN，
它包括了一些用于改变样式的属性，这些属性继承自WebControl,
如: BorderColor,BorderStyle,BackColor,ControlStyle,CssClass,Font,ForColor,Height,Width..
另外，也有Attributes,Controls，Context，Event，Page，Parent，TemplateControl，ViewState等继承Control的属性
2.5 GirdViewRow对象的一些方法
方法也很多，需要时参考MSDN，常用的，包括：
FindControl,HasControl,ClearChildControlState…
3. TableCell 对象
TableCell对象表示 Table 控件中的单元格。通过GridViewRow.Cells对象就是返回的TablelCell的集合。
对于WEB来说，其就是一个<td></td>
该对象有一些常用的属性，如Text，Controls.RowSpan,ToolTip,VerticalAlign,HorizontalAlign…属性
关于Control对象，MSDN上有一些说明：
在 ASP.NET 页上，当以声明方式在服务器控件的开始标记和结束标记之间添加控件时，ASP.NET 会自动将这些控件添加到包含服务器控件的 ControlCollection 中。任何不在服务器上处理的 HTML 标记或者文本字符串都视为 LiteralControl 对象。它们像其他服务器控件一样被添加到集合中。
Controls 属性允许编程访问任何服务器控件的 ControlCollection 类实例。您可以向集合添加控件、从集合中移除控件，或者循环访问集合中的服务器控件。
Controls.Add(new LiteralControl("<h3>Value: "));
扫一扫
2038
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
