当单击 GridView 控件中的按钮时发生。

在单击 GridView 控件中的按钮时，将引发 RowCommand 事件。 这使您可以提供一个这样的事件处理方法，即每次发生此事件时就执行一个自定义例程。

GridView 控件中的按钮也可调用该控件的某些内置功能。 若要执行这些操作之一，请将按钮的 CommandName 属性设置为下表中的某个值。

 

CommandName 值

描述

“Cancel”

取消编辑操作并将 GridView 控件返回为只读模式。 引发 RowCancelingEdit 事件。

“Delete”

删除当前记录。 引发 RowDeleting 和 RowDeleted 事件。

“Edit”

将当前记录置于编辑模式。 引发 RowEditing 事件。

“Page”

执行分页操作。 将按钮的 CommandArgument 属性设置为“First”、“Last”、“Next”、“Prev”或页码，以指定要执行的分页操作类型。 引发 PageIndexChanging 和 PageIndexChanged 事件。

“Select”

选择当前记录。 引发 SelectedIndexChanging 和 SelectedIndexChanged 事件。

“Sort”

对 GridView 控件进行排序。 引发 Sorting 和 Sorted 事件。

“Update”

更新数据源中的当前记录。 引发 RowUpdating 和 RowUpdated 事件。

尽管单击上表中所列出的按钮时将引发 RowCommand 事件，但仍建议您使用该表中列出的事件来执行该操作。

GridViewCommandEventArgs 对象将传递给事件处理方法，以便您可以确定被单击按钮的命令名和命令参数。

说明说明

若要确定事件中引发的行的索引，请使用传递给该事件的事件参数的 CommandArgument 属性。 ButtonField 类自动以适当的索引值填充 CommandArgument 属性。 对于其他命令按钮，您必须手动设置命令按钮的 CommandArgument 属性。 例如，当 GridView 控件未启用分页功能时，您可以将 CommandArgument 设置为 <%# Container.DataItemIndex %>。