ObjectDataSourceView クラス

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

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、、および Insert 操作、並べ替え、フィルター処理、およびビューステートに保持される設定の管理などSelectUpdateDelete、コントロールのデータ機能ObjectDataSourceを実装します。

ObjectDataSourceViewオブジェクトは、実行時に クラスの各インスタンスに対してObjectDataSource作成されます。 クラスのインスタンスのデータ操作の ObjectDataSource 呼び出しは、 オブジェクトの ObjectDataSourceView インスタンスによって処理されます。 ページ開発者は、 クラスのインスタンスに ObjectDataSourceView 直接アクセスしません。 コントロール開発者は、 クラスと ObjectDataSourceView クラスを拡張することで、カスタム データ コントロールをObjectDataSource作成できます。

クラスは ObjectDataSourceView 、リフレクションを使用してビジネス オブジェクトまたはデータ オブジェクトに対してメソッドを呼び出すことによって、データ操作を実行します。 実行時に、コントロールは ObjectDataSource プロパティによって識別される型のインスタンスを TypeName 作成し、データ操作に適したメソッドを呼び出します。 インスタンス化されたオブジェクトは、 によってメモリに ObjectDataSourceViewキャッシュされません。 オブジェクトは、すべてのデータ メソッド呼び出しに対して作成および破棄されます。 メソッドが static (Shared Visual Basic の場合) の場合、インスタンスは作成されませんが、データ操作メソッドは引き続き呼び出されます。

ObjectDataSourceViewは、コントロールによってObjectDataSourceページ開発者に直接公開されません。 代わりに、 のプロパティとメソッド ObjectDataSourceView は を ObjectDataSource介してアクセスされます。 たとえば、 プロパティの は DeleteMethod 、 の ObjectDataSourceView プロパティを DeleteMethod 設定することによって設定されます ObjectDataSource。

データの取得

データ ソース ビューで実行される最も基本的な操作は、 メソッドを使用して Select 基になるデータ ストレージからデータを取得し、データ項目のコレクションを IEnumerable 取得することです。 次のデータ取得メソッド、プロパティ、およびイベントは、 オブジェクトによって ObjectDataSourceView 実装され、その ObjectDataSource コントロールによってページ開発者や他の呼び出し元に直接公開されます。

• Select メソッド

• SelectMethod プロパティ

• SelectParameters プロパティ

• Selecting イベント

• Selected イベント

データの更新

オブジェクトは ObjectDataSourceView 、 プロパティで識別されるビジネス オブジェクトまたはデータ オブジェクト メソッドを呼び出すことによって、データ更新を UpdateMethod サポートします。 コントロールや コントロールなどのGridView更新を自動的に実行するデータ バインド コントロールは、インターフェイス内のパラメーターを IOrderedDictionary にObjectDataSourceView渡し、ビュー オブジェクトはこれらのパラメーターをコレクション内にあるUpdateParametersパラメーターとマージDetailsViewします。

次の更新メソッド、プロパティ、およびイベントは によって ObjectDataSourceView 実装され、その ObjectDataSource コントロールによってページ開発者や他の呼び出し元に直接公開されます。

• Update メソッド

• UpdateMethod プロパティ

• UpdateParameters プロパティ

• Updating イベント

• Updated イベント

データの挿入

オブジェクトは ObjectDataSourceView 、 プロパティによって識別されるビジネス オブジェクトメソッドまたはデータ オブジェクト メソッドを呼び出すことによって、新しいデータ行の挿入を InsertMethod サポートします。 や などのGridView挿入を自動的に実行するデータ バインド コントロールは、インターフェイス内のパラメーターを IOrderedDictionary にObjectDataSourceView渡し、ビュー オブジェクトはこれらのパラメーターをコレクション内InsertParametersにあるパラメーターとマージDetailsViewします。

次の挿入メソッド、プロパティ、およびイベントは によって ObjectDataSourceView 実装され、その ObjectDataSource コントロールによってページ開発者や他の呼び出し元に直接公開されます。

• Insert メソッド

• InsertMethod プロパティ

• InsertParameters プロパティ

• Inserting イベント

• Inserted イベント

データの削除

オブジェクトは ObjectDataSourceView 、 プロパティによって識別されるビジネス オブジェクトメソッドまたはデータ オブジェクト メソッドを呼び出してデータの削除を DeleteMethod サポートします。 や などのGridView削除を自動的に実行するデータ バインド コントロールは、インターフェイス内のパラメーターを IOrderedDictionary にObjectDataSourceView渡し、ビュー オブジェクトはこれらのパラメーターをコレクション内にあるDeleteParametersパラメーターとマージDetailsViewします。 次の削除メソッド、プロパティ、およびイベントは によって ObjectDataSourceView 実装され、そのコントロールによって ObjectDataSource ページ開発者や他の呼び出し元に直接公開されます。

• Delete メソッド

• DeleteMethod プロパティ

• DeleteParameters プロパティ

• Deleting イベント

• Deleted イベント

データのフィルター処理と並べ替え

データを動的にフィルター処理できる場合は、データの取得がより強力になります。 フィルター処理は、 メソッドが または オブジェクトをObjectDataSource返すDataTable場合Selectにのみ、コントロールによってサポートDataSetされます。 プロパティと FilterParameters プロパティをFilterExpression使用して、動的フィルター処理をデータ取得に適用できます。 これらのプロパティは オブジェクトによって ObjectDataSourceView 実装され、その ObjectDataSource コントロールによってデータ バインド コントロールやその他の呼び出し元に直接公開されます。

を使用して取得 ObjectDataSource したデータを並べ替えるには、取得後にメモリ内のデータを並べ替えます。 並べ替えは、 メソッドが または をObjectDataSource返すDataTable場合Selectにのみ、コントロールによってサポートDataSetされます。 プロパティは CanSort 常に を true返します。これは、 メソッドを ObjectDataSourceView 呼び出さずに、 メソッドによって返される型を Select 判断できないためです。 プロパティ構文は SortExpression 、 プロパティの 構文と DataView.Sort 同じです。

追跡ビューの状態

は ObjectDataSourceView インターフェイスを IStateManager 実装し、ビューステートを使用してページ要求全体でその状態を追跡します。 コントロールの LoadViewStateビューステート追跡を有効にするために、、 SaveViewState、および TrackViewState メソッドの実装が提供されます。 詳細については、「 ASP.NET State Management の概要」を参照してください。

コンストラクター

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 オブジェクトが呼び出すメソッドまたは関数の名前を取得または設定します。
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)	指定した keys コレクションと oldValues コレクションを使用して、DeleteMethod プロパティで指定されたビジネス オブジェクト メソッドを呼び出すことで、削除操作を実行します。
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)	指定した values コレクションを使用して、InsertMethod プロパティで指定されたビジネス オブジェクト メソッドを呼び出すことで、挿入操作を実行します。
ExecuteSelect(DataSourceSelectArguments)	TypeName プロパティで指定されたメソッドを呼び出し、SelectMethod コレクション内の任意の値を渡すことにより、SelectParameters プロパティで指定されたオブジェクトからデータを取得します。
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	UpdateMethod プロパティで指定されたメソッドを keys、values、oldValues の各コレクションで提供された任意のパラメーターを使用して呼び出すことにより、更新操作を実行します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Insert(IDictionary)	指定した values コレクションを使用して、InsertMethod プロパティで指定されたビジネス オブジェクト メソッドを呼び出すことで、挿入操作を実行します。
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()」をご覧ください。

こちらもご覧ください

• ObjectDataSource
• DataSourceView