DetailsView.InsertItem(Boolean) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將目前的資料錄插入資料來源。

public:
 virtual void InsertItem(bool causesValidation);

public virtual void InsertItem (bool causesValidation);

abstract member InsertItem : bool -> unit
override this.InsertItem : bool -> unit

Public Overridable Sub InsertItem (causesValidation As Boolean)

true 表示呼叫此方法時會執行頁面驗證，否則為 false。

HttpException

當 DetailsView 控制項未處於插入模式時，會呼叫這個方法。

-或-

與 DataSourceView 控制項關聯的 DetailsView 為 null。

DetailsView當控制項處於插入模式時，請使用 InsertItem 方法，以程式設計方式在資料來源中插入目前的記錄。當您需要從控制項外部 DetailsView 插入目前記錄時，通常會使用這個方法，例如來自頁面上的不同控制項。

注意

呼叫這個方法時， DetailsView 控制項必須處於插入模式， HttpException 否則會擲回例外狀況。

若要指定是否在插入作業之前執行頁面驗證，請使用 causesValidation 參數。呼叫這個方法也會引發 ItemInserted 和 ItemInserting 事件。