FormView.OnBubbleEvent(Object, EventArgs) 方法

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.dll

处理在控件层次结构中向上传递的事件。

protected:
 override bool OnBubbleEvent(System::Object ^ source, EventArgs ^ e);

protected override bool OnBubbleEvent (object source, EventArgs e);

override this.OnBubbleEvent : obj * EventArgs -> bool

Protected Overrides Function OnBubbleEvent (source As Object, e As EventArgs) As Boolean

参数

source

Object

事件源。

e

EventArgs

包含事件数据的 EventArgs。

返回

Boolean

若要指示事件应在控件层次结构中进一步向上传递，则为 true；否则为 false。

注解

控件 Control.OnBubbleEvent 使用 方法选择性地处理通过 控件层次结构传递 RaiseBubbleEvent 的事件。 它通过检查 参数中包含的e对象的属性EventArgs确定是否处理事件。 需要处理事件时， 方法将执行相应的操作。 其他事件将被忽略并向上传递控件层次结构。 此方法指示是否通过其返回值将事件进一步向上传递控件层次结构。

控件 FormView 重写此方法的基本实现，以在单击控件识别的按钮之一时执行相应的操作。 下表列出了控件识别的 FormView 命令按钮。

Button	CommandName 值	说明
取消	“取消”	用于更新或插入操作以取消操作并放弃用户输入的值。 然后，控件 FormView 将返回到 属性指定的 DefaultMode 模式。
删除	“Delete”	用于删除操作以从数据源中删除显示的记录。 引发 ItemDeleting 和 ItemDeleted 事件。
编辑	“编辑”	用于更新操作以将 FormView 控件置于编辑模式。 为数据行显示 属性中指定的 EditItemTemplate 内容。
插入	“插入”	用于插入操作，以尝试使用用户提供的值在数据源中插入新记录。 引发 ItemInserting 和 ItemInserted 事件。
新建	“新建”	在插入操作中用于将控件置于 FormView 插入模式。 为数据行显示 属性中指定的 InsertItemTemplate 内容。
页面	“Page”	在分页操作中用于表示执行分页的寻呼行中的按钮。 若要指定分页操作，请将按钮的 属性设置为 CommandArgument “Next”、“Prev”、“First”、“Last”或要导航到的页面的索引。 引发 PageIndexChanging 和 PageIndexChanged 事件。 注意： 这种类型的按钮通常仅在寻呼模板中使用。
更新	“Update”	用于更新操作，以尝试使用用户提供的值更新数据源中显示的记录。 引发 ItemUpdating 和 ItemUpdated 事件。

处理其中一个按钮时，此方法的此版本将返回 true 。 有关事件冒泡的详细信息，请参阅 处理和引发事件。

继承者说明

扩展 FormView 类时，可以重写此方法来处理自己的事件。 请确保使用返回值来指示是否应在控件层次结构中进一步传递事件。

另请参阅

• OnBubbleEvent(Object, EventArgs)
• EventArgs