ObjectDataSourceView 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

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

支援 ObjectDataSource 控制項，並提供資料繫結控制項的介面，以藉由商務和資料物件執行資料作業。

public ref class ObjectDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class ObjectDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type ObjectDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class ObjectDataSourceView
Inherits DataSourceView
Implements IStateManager

繼承: Object

DataSourceView
ObjectDataSourceView

實作: IStateManager

備註

類別 ObjectDataSourceView 主要是供資料繫結控制項使用，而不是頁面程式碼中的可程式化物件。

類別 ObjectDataSourceView 會實作 ObjectDataSource 控制項的資料功能，包括 Select 、 Update 、 Delete 和 Insert 作業、排序、篩選和管理保留在檢視狀態中的設定。

ObjectDataSourceView物件會在執行時間針對類別的每個實例 ObjectDataSource 建立。對類別實例 ObjectDataSource 的資料作業呼叫是由物件的實例 ObjectDataSourceView 處理。頁面開發人員不會直接存取類別的 ObjectDataSourceView 實例。控制項開發人員可以藉由擴充 ObjectDataSource 和 ObjectDataSourceView 類別來建立自訂資料控制項。

類別 ObjectDataSourceView 會藉由使用反映在商務或資料物件上呼叫方法來執行資料作業。在執行時間， ObjectDataSource 控制項會建立屬性所 TypeName 識別之型別的實例，然後呼叫資料作業的適當方法。具現化物件不會由 ObjectDataSourceView 快取在記憶體中。物件會針對每個資料方法呼叫建立和終結。如果在 Visual Basic) 中 (Shared 方法 static ，則不會建立實例，但仍會呼叫資料作業方法。

不會 ObjectDataSourceView 由 ObjectDataSource 控制項直接向頁面開發人員公開。相反地，會透過存取 ObjectDataSource 的 ObjectDataSourceView 屬性和方法。例如，藉 DeleteMethod ObjectDataSourceView 由設定 DeleteMethod 的屬性來設定屬性。 ObjectDataSource

擷取資料

資料來源檢視執行的最基本作業是從基礎資料儲存體擷取資料，此方法會 IEnumerable 擷 Select 取資料項目的集合。物件會 ObjectDataSourceView 實作下列資料擷取方法、屬性和事件，並由其 ObjectDataSource 控制項直接公開給頁面開發人員和其他呼叫端：

Select 方法
SelectMethod 屬性
SelectParameters 屬性
Selecting 事件
Selected 事件

更新資料

物件 ObjectDataSourceView 支援資料更新，方法是呼叫屬性所 UpdateMethod 識別的商務或資料物件方法。自動執行更新的資料繫結控制項，例如 GridView 和 DetailsView 控制項，將其參數 IOrderedDictionary 傳遞至， ObjectDataSourceView 而檢視物件會將這些參數與集合中找到 UpdateParameters 的任何參數合併。

下列更新方法、屬性和事件是由實作， ObjectDataSourceView 並由其 ObjectDataSource 控制項直接公開給頁面開發人員和其他呼叫端：

Update 方法
UpdateMethod 屬性
UpdateParameters 屬性
Updating 事件
Updated 事件

插入資料

物件 ObjectDataSourceView 支援呼叫屬性所 InsertMethod 識別的商務或資料物件方法，以插入新的資料列。自動執行插入的資料繫結控制項，例如 GridView 和 DetailsView ，會將其參數 IOrderedDictionary 傳遞至， ObjectDataSourceView 而檢視物件會將這些參數與集合中找到 InsertParameters 的任何參數合併。

下列插入方法、屬性和事件是由實作， ObjectDataSourceView 並由其 ObjectDataSource 控制項直接公開給頁面開發人員和其他呼叫端：

Insert 方法
InsertMethod 屬性
InsertParameters 屬性
Inserting 事件
Inserted 事件

刪除資料

物件 ObjectDataSourceView 支援呼叫屬性所 DeleteMethod 識別的商務或資料物件方法來刪除資料。自動執行刪除的資料繫結控制項，例如 GridView 和 DetailsView ，會將其參數 IOrderedDictionary 傳遞至， ObjectDataSourceView 而檢視物件會將這些參數與集合中找到 DeleteParameters 的任何參數合併。下列刪除方法、屬性和事件是由實作， ObjectDataSourceView 並由其 ObjectDataSource 控制項直接公開給頁面開發人員和其他呼叫端：

Delete 方法
DeleteMethod 屬性
DeleteParameters 屬性
Deleting 事件
Deleted 事件

篩選與排序資料

當您可以動態篩選資料時，資料擷取功能更強大。只有在方法傳回 DataTable 或 DataSet 物件時 Select ， ObjectDataSource 控制項才支援篩選。您可以使用 FilterExpression 和 FilterParameters 屬性，將動態篩選套用至資料擷取。這些屬性是由物件實 ObjectDataSourceView 作，並由其 ObjectDataSource 控制項直接公開給資料繫結控制項和其他呼叫端。

您可以藉由排序擷取記憶體中的資料，來排序所擷 ObjectDataSource 取的資料。只有在 ObjectDataSource 方法傳回 DataTable 或 DataSet 時 Select ，控制項才支援排序。屬性 CanSort 一律會傳 true 回，因為 ObjectDataSourceView 無法判斷方法傳 Select 回的類型，而不需呼叫方法。屬性 SortExpression 語法與屬性相同 DataView.Sort 。

追蹤檢視狀態

會 ObjectDataSourceView 實作介面， IStateManager 並使用檢視狀態來追蹤其跨頁面要求的狀態。提供、 SaveViewState 和 TrackViewState 方法的 LoadViewState 實作，以啟用控制項的檢視狀態追蹤。如需詳細資訊，請參閱 ASP.NET 狀態管理概觀。

建構函式

ObjectDataSourceView(ObjectDataSource, String, HttpContext)

初始化 ObjectDataSourceView 類別的新執行個體。

屬性

CanDelete	取得值，指出與目前 ObjectDataSourceView 控制項關聯的 ObjectDataSource 物件是否支援刪除作業。
CanInsert	取得值，指出與目前 ObjectDataSourceView 控制項關聯的 ObjectDataSource 物件是否支援插入作業。
CanPage	取得值，指出與目前 ObjectDataSourceView 控制項關聯的 ObjectDataSource 物件是否支援對擷取的資料進行分頁。
CanRetrieveTotalRowCount	取得值，指出與目前 ObjectDataSourceView 控制項關聯的 ObjectDataSource 物件是否除了支援擷取資料集以外，還支援擷取資料列的總數。
CanSort	取得值，指出與目前 ObjectDataSource 控制項相關聯的 ObjectDataSourceView 物件，在基礎資料來源上是否支援排序的檢視。
CanUpdate	取得值，指出與目前 ObjectDataSourceView 控制項關聯的 ObjectDataSource 物件是否支援更新作業。
ConflictDetection	取得或設定值，判斷在作業期間，當基礎資料儲存中資料列中的資料發生變更時，ObjectDataSource 控制項如何執行更新和刪除作業。
ConvertNullToDBNull	取得或設定值，指出傳遞至更新、插入或刪除作業的 Parameter 值是否自動從 `null` 轉換為 Value 值。
DataObjectTypeName	取得或設定類別的名稱，ObjectDataSource 控制項會將該名稱用於資料作業中的參數。 ObjectDataSource 控制項會使用指定的類別，而不是各種參數集合中的 Parameter 物件。
DeleteMethod	取得或設定 ObjectDataSourceView 物件叫用 (Invoke) 以刪除資料之方法或函式的名稱。
DeleteParameters	取得包含 DeleteMethod 方法所用參數的參數集合。
EnablePaging	取得或設定值，指出資料來源控制項是否支援對其擷取的資料集進行分頁。
Events	取得資料來源檢視的事件處理常式委派清單。 (繼承來源 DataSourceView)
FilterExpression	取得或設定呼叫 SelectMethod 屬性所識別之商務物件方法時套用的篩選條件運算式。
FilterParameters	取得與 FilterExpression 字串中任何參數替代符號相關聯的參數集合。
InsertMethod	取得或設定 ObjectDataSourceView 物件叫用以插入資料之方法或函式的名稱。
InsertParameters	取得包含 InsertMethod 方法所用參數的參數集合。
IsTrackingViewState	取得值，指出 ObjectDataSourceView 物件是否正在將變更儲存到它的檢視狀態。
MaximumRowsParameterName	取得或設定資料擷取方法參數的名稱，用於指出為資料來源分頁支援所擷取的資料錄數目。
Name	取得資料來源檢視的名稱。 (繼承來源 DataSourceView)
OldValuesParameterFormatString	取得或設定格式字串，套用至傳遞給 `Delete` 或 `Update` 方法之原始值的參數名稱。
ParsingCulture	取得或設定值，指出在將字串值轉換成實際的屬性型別，以建構 DataObjectTypeName 所表示的型別物件時，使用何種文化特性資訊。
SelectCountMethod	取得或設定 ObjectDataSourceView 控制項叫用以擷取資料列計數之方法或函式的名稱。
SelectMethod	取得或設定 ObjectDataSourceView 控制項叫用以擷取資料之方法或函式的名稱。
SelectParameters	取得包含 SelectMethod 方法所用參數的參數集合。
SortParameterName	取得或設定資料擷取方法參數的名稱，用於指定資料來源排序支援的排序運算式。
StartRowIndexParameterName	取得或設定資料擷取方法參數的名稱，用於指出為資料來源分頁支援而從結果集擷取之第一個資料錄的整數索引。
TypeName	取得或設定 ObjectDataSource 控制項表示的類別名稱。
UpdateMethod	取得或設定 ObjectDataSourceView 物件叫用以更新資料之方法或函式的名稱。
UpdateParameters	取得包含 UpdateMethod 方法所用參數的參數集合。

方法

CanExecute(String)	判斷是否可以執行指定的命令。 (繼承來源 DataSourceView)
Delete(IDictionary, IDictionary)	藉由呼叫由 DeleteMethod 屬性所識別的商務物件方法，同時使用指定的 `keys` 和 `oldValues` 集合，執行刪除作業。
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	在 DataSourceView 物件表示的資料清單上，執行非同步刪除作業。 (繼承來源 DataSourceView)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
ExecuteCommand(String, IDictionary, IDictionary)	執行指定命令。 (繼承來源 DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	執行指定命令。 (繼承來源 DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	使用 DeleteMethod 方法和指定的 `keys` 與 `oldValues` 集合，執行刪除作業。
ExecuteInsert(IDictionary)	藉由呼叫由 InsertMethod 屬性所識別的商務物件方法，同時使用指定的 `values` 集合，執行插入作業。
ExecuteSelect(DataSourceSelectArguments)	藉由呼叫由 TypeName 屬性所識別的方法並傳遞 SelectMethod 集合中的任何值，可以從 SelectParameters 屬性所識別的物件中擷取值。
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	藉由呼叫由 UpdateMethod 屬性所識別的方法，同時使用 `keys`、`values` 或 `oldValues` 集合中提供的任何參數，執行更新作業。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Insert(IDictionary)	藉由呼叫由 InsertMethod 屬性所識別的商務物件方法，同時使用指定的 `values` 集合，執行插入作業。
Insert(IDictionary, DataSourceViewOperationCallback)	在 DataSourceView 物件表示的資料清單上，執行非同步插入作業。 (繼承來源 DataSourceView)
LoadViewState(Object)	還原資料來源檢視之先前儲存的檢視狀態。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnDataSourceViewChanged(EventArgs)	引發 DataSourceViewChanged 事件。 (繼承來源 DataSourceView)
OnDeleted(ObjectDataSourceStatusEventArgs)	在 Deleted 物件完成刪除作業之後，引發 ObjectDataSourceView。
OnDeleting(ObjectDataSourceMethodEventArgs)	在 Deleting 物件嘗試刪除作業之前，引發 ObjectDataSourceView 事件。
OnFiltering(ObjectDataSourceFilteringEventArgs)	在 Filtering 物件嘗試篩選作業之前，引發 ObjectDataSourceView 事件。
OnInserted(ObjectDataSourceStatusEventArgs)	在 Inserted 物件完成插入作業之後，引發 ObjectDataSourceView。
OnInserting(ObjectDataSourceMethodEventArgs)	在 Inserting 物件嘗試插入作業之前，引發 ObjectDataSourceView 事件。
OnObjectCreated(ObjectDataSourceEventArgs)	在 ObjectCreated 建立由 ObjectDataSourceView 屬性所識別之物件的執行個體之後，引發 TypeName 事件。
OnObjectCreating(ObjectDataSourceEventArgs)	在 ObjectCreating 物件建立商務物件的執行個體以執行資料作業之前，引發 ObjectDataSourceView 事件。
OnObjectDisposing(ObjectDataSourceDisposingEventArgs)	在 ObjectDisposing 物件捨棄執行個體化型別之前，引發 ObjectDataSourceView 事件。
OnSelected(ObjectDataSourceStatusEventArgs)	在 Selected 物件完成資料擷取作業之後，引發 ObjectDataSourceView。
OnSelecting(ObjectDataSourceSelectingEventArgs)	在 Selecting 物件嘗試資料擷取作業之前，引發 ObjectDataSourceView 事件。
OnUpdated(ObjectDataSourceStatusEventArgs)	在 Updated 物件完成更新作業之後，引發 ObjectDataSourceView。
OnUpdating(ObjectDataSourceMethodEventArgs)	在 Updating 物件嘗試更新作業之前，引發 ObjectDataSourceView 事件。
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	由 RaiseUnsupportedCapabilitiesError(DataSourceView) 方法呼叫，以比較針對 ExecuteSelect(DataSourceSelectArguments) 作業要求的功能與檢視支援的功能。 (繼承來源 DataSourceView)
SaveViewState()	儲存自頁面回傳至伺服器以來，ObjectDataSourceView 物件檢視狀態的變更。
Select(DataSourceSelectArguments)	藉由呼叫由 TypeName 屬性所識別的方法並傳遞 SelectMethod 集合中的任何值，可以從 SelectParameters 屬性所識別的物件中擷取值。
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	從基礎資料儲存區非同步取得資料清單。 (繼承來源 DataSourceView)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TrackViewState()	讓 ObjectDataSourceView 追蹤其檢視狀態變更，以將變更儲存在控制項的 ViewState 物件中，並持續為相同頁面的其他要求進行追蹤。
Update(IDictionary, IDictionary, IDictionary)	藉由呼叫由 UpdateMethod 屬性所識別的方法，同時使用 `keys`、`values` 或 `oldValues` 集合中提供的任何參數，執行更新作業。
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	在 DataSourceView 物件表示的資料清單上，執行非同步更新作業。 (繼承來源 DataSourceView)

事件

DataSourceViewChanged	當資料來源檢視已變更時發生。 (繼承來源 DataSourceView)
Deleted	發生於 Delete 作業已經完成時。
Deleting	在 Delete 作業之前發生。
Filtering	在篩選作業之前發生。
Inserted	發生於 Insert 作業已經完成時。
Inserting	在 Insert 作業之前發生。
ObjectCreated	在 ObjectDataSourceView 物件建立由 TypeName 屬性所識別之型別的執行個體之後發生。
ObjectCreating	在 ObjectDataSourceView 物件建立由 TypeName 屬性所識別之型別的執行個體之前發生。
ObjectDisposing	發生於 ObjectDataSourceView 物件捨棄其所建立之物件的執行個體時。
Selected	發生於資料擷取作業已經完成時。
Selecting	在資料擷取作業之前發生。
Updated	發生於 Update 作業已經完成時。
Updating	在 Update 作業之前發生。

明確介面實作

IStateManager.IsTrackingViewState	如需這個成員的說明，請參閱 IsTrackingViewState。
IStateManager.LoadViewState(Object)	如需這個成員的說明，請參閱 LoadViewState(Object)。
IStateManager.SaveViewState()	如需這個成員的說明，請參閱 SaveViewState()。
IStateManager.TrackViewState()	如需這個成員的說明，請參閱 TrackViewState()。

適用於