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 命令按鈕。

按鈕	CommandName 值	描述
取消	「Cancel」	用於更新或插入作業以取消作業，並捨棄使用者輸入的值。 控制項 FormView 接著會返回 屬性所 DefaultMode 指定的模式。
刪除	"Delete"	用於刪除作業，以從資料來源中刪除顯示的記錄。 ItemDeleting引發 和 ItemDeleted 事件。
編輯	「Edit」	用於更新作業，讓控制項處於 FormView 編輯模式。 在 屬性中指定的 EditItemTemplate 內容會顯示為數據列。
插入	「Insert」	用於插入作業，以使用使用者所提供的值，嘗試在資料來源中插入新記錄。 ItemInserting引發 和 ItemInserted 事件。
新增	「New」	用於插入作業，將控制項置於 FormView 插入模式。 在 屬性中指定的 InsertItemTemplate 內容會顯示為數據列。
頁面	「Page」	用於分頁作業，代表執行分頁之頁面巡覽列中的按鈕。 若要指定分頁作業，請將按鈕的 屬性設定 CommandArgument 為 「Next」、「Prev」、「First」、「Last」 或要巡覽的頁面索引。 PageIndexChanging引發 和 PageIndexChanged 事件。 注意： 這種類型的按鈕通常只會在呼叫器範本中使用。
更新	「Update」	用於更新作業，以使用使用者所提供的值，嘗試更新資料來源中顯示的記錄。 ItemUpdating引發 和 ItemUpdated 事件。

這個版本的 方法會在 true 處理其中一個按鈕時傳回。 如需事件反升的詳細資訊，請參閱 處理和引發事件。

給繼承者的注意事項

擴充 FormView 類別時，您可以覆寫這個方法來處理您自己的事件。 請務必使用傳回值來指出是否應該將事件進一步傳遞至控制階層。

另請參閱

• OnBubbleEvent(Object, EventArgs)
• EventArgs