ListView.OnItemInserting(ListViewInsertEventArgs) 方法

定義

引發 ItemInserting 事件。

protected:
 virtual void OnItemInserting(System::Web::UI::WebControls::ListViewInsertEventArgs ^ e);
protected virtual void OnItemInserting (System.Web.UI.WebControls.ListViewInsertEventArgs e);
abstract member OnItemInserting : System.Web.UI.WebControls.ListViewInsertEventArgs -> unit
override this.OnItemInserting : System.Web.UI.WebControls.ListViewInsertEventArgs -> unit
Protected Overridable Sub OnItemInserting (e As ListViewInsertEventArgs)

參數

e
ListViewInsertEventArgs

事件資料。

例外狀況

使用 DataSourceID 屬性並不會將 ListView 控制項繫結至資料來源控制項。

備註

ListView當按一下控制項中的 [插入] 按鈕或 InsertNewItem 呼叫 方法,但在控制項插入記錄之前 ListView ,控制項就會引發 ItemInserting 事件。 (Insert 按鈕是一個按鈕控制項,其 CommandName 屬性設定為 「Insert」。) 這可讓您在發生此事件時執行自訂常式,例如 HTML 編碼或驗證記錄的值,然後再插入資料來源中。

方法 OnItemInserting 是由 ListView 控制項呼叫,以引發 ItemInserting 事件。 在擴充 ListView 類別時,控制項開發人員通常會使用它。

引發事件會透過委派叫用此事件處理常式。 如需詳細資訊,請參閱 處理和引發事件

方法 OnItemInserting 也可讓衍生類別處理事件,而不附加委派。 這是在衍生類別中處理事件的慣用技巧。

給繼承者的注意事項

當您在衍生類別中覆寫 OnItemInserting(ListViewInsertEventArgs) 時,請呼叫基類 OnItemInserting(ListViewInsertEventArgs) 的 方法,讓已註冊的委派接收事件。

適用於

另請參閱