EntityDataSource 事件

更新:2007 年 11 月

除了全標記案例中的可能項目外,EntityDataSource 控制項所公開的事件可以讓您加入到 ASP.NET 應用程式。事件處理常式可以用於驗證料、為不屬於資料繫結的屬性提供屬性值、擷取查詢結果相關的資料,並且管理用於查詢及更新資料的 ObjectContext 生命週期。

如需一般的資料來源控制項事件說明,請參閱與 ASP.NET 資料控制項插入、更新及刪除功能關聯的事件 (英文)。

事件

說明

ContextCreating

ContextCreating 事件提供 EntityDataSource 控制項為進行後續作業所要使用的 ObjectContext 執行個體。如需詳細資訊,請參閱物件內容生命週期管理

ContextCreated

ContextCreated 事件可以讓您存取由 EntityDataSource 控制項所建立的 ObjectContext 執行個體。可以儲存這個內容物件並供 EntityDataSource 以外的後續作業使用。如需詳細資訊,請參閱物件內容生命週期管理

ContextDisposing

ContextDisposing 事件可以讓您預防 EntityDataSource 控制項使用的 ObjectContext 不會受到處置。處理這個事件的時機:想要在網頁上使用單一 ObjectContext 執行個體以供多個控制項或 EntityDataSource 控制項的多個執行個體使用時。

Selecting

Selecting 事件可以讓您修改 EntityDataSource 的設定,並且在查詢建構與執行之前,讀取或變更來自資料繫結控制項的引數。處理這個事件的時機:想要修改控制項的分頁或排序行為或取消查詢時。

Selected

Selected 事件可以讓您存取查詢的結果並且擷取資料列計數的資訊。處理這個事件的時機:想要存取物件結果或在檢視狀態中儲存物件時。

Inserting

Inserting 事件可以讓您修改或驗證已加入的物件、新增其他不同的物件或取消作業。處理這個事件的時機:要從 EntityDataSourceChangingEventArgs 物件的 Entity 屬性存取物件以便新增時。

Inserted

Inserted 事件可以讓您存取資料來源中建立的物件。EntityDataSourceChangedEventArgs 物件的 Entity 屬性會用於存取加入的物件。

Updating

Updating 事件可以讓您修改或驗證已加入的物件、提供其他不同的物件,或者在保存變更前取消作業。您可以從 EntityDataSourceChangingEventArgs 物件的 Entity 屬性存取修改過的物件。處理這個事件的時機:想要驗證 (Verify) 或驗證 (Validate) 變更,或是修改物件的 ObjectStateEntry 以設定不同的並行控制原始值時。如需詳細資訊,請參閱儲存變更及管理並行 (Entity Framework)

Updated

Updated 事件可以讓您存取變更才剛剛存入資料來源的物件。EntityDataSourceChangedEventArgs 物件的 Entity 屬性會用於存取已更新的物件。

Deleting

Deleting 事件可以讓您在物件自資料來源刪除前存取物件或取消作業。EntityDataSourceChangingEventArgsEntity 屬性會保留要被刪除的物件。

Deleted

Deleted 事件可以讓您存取自資料來源刪除的物件。EntityDataSourceChangingEventArgs 物件的 Entity 屬性會用於存取已刪除的物件。傳回的物件會處於 Detached 狀態。

Exception()

會實作 IDynamicDataSource.Exception 事件,以提供與 ASP.NET Dynamic Data 的相容性。這個事件的處理常式無法在標記中註冊。只有在 EntityDataSource 執行個體轉換為 IDynamicDataSource 介面時才能使用這個成員。如需詳細資訊,請參閱 ASP.NET 動態資料模型概觀

請參閱

概念

物件內容生命週期管理 (EntityDataSource)

設定 EntityDataSource 控制項

更新資料 (EntityDataSource)

EntityDataSource 設計工具

其他資源

使用 EntityDataSource 進行資料選取

使用 ASP.NET 動態資料