ObjectDataSourceView.ExecuteSelect メソッド

.NET Framework クラス ライブラリ リファレンス

ObjectDataSourceView.ExecuteSelect メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

SelectMethod プロパティで指定されたメソッドを呼び出し、SelectParameters コレクション内の任意の値を渡すことにより、TypeName プロパティで指定されたオブジェクトからデータを取得します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overrides
 Function ExecuteSelect ( _
    arguments As DataSourceSelectArguments _
) As IEnumerable

Visual Basic (使用法)

Dim arguments As DataSourceSelectArguments
Dim returnValue As IEnumerable

returnValue = Me.ExecuteSelect(arguments)

C#

protected internal override IEnumerable ExecuteSelect (
    DataSourceSelectArguments arguments
)

C++

protected public:
virtual IEnumerable^ ExecuteSelect (
    DataSourceSelectArguments^ arguments
) override

J#

protected IEnumerable ExecuteSelect (
    DataSourceSelectArguments arguments
)

JScript

protected internal override function
 ExecuteSelect (
    arguments : DataSourceSelectArguments
) : IEnumerable

パラメータ

arguments

基本的なデータ取得を超えたデータ操作を要求する場合に使用する DataSourceSelectArguments。

戻り値
データ行の IEnumerable リスト。

例外

例外の種類	条件
NotSupportedException	ExecuteSelect メソッドに渡される arguments が、データを取得するときに、取得したデータに対するページングまたは並べ替えを有効にするには、データ ソースで追加の作業が必要であることを指定していますが、データ ソース コントロールが要求された機能をサポートしていません。 または ExecuteSelect メソッドから返されたオブジェクトが DataSet または DataTable でなく、かつキャッシュが有効になっています。ObjectDataSourceView コントロールに対して、DataSet オブジェクトと DataTable オブジェクトのみがキャッシュできます。 または キャッシュとクライアント偽装の両方が有効になっています。ObjectDataSource は、クライアント偽装が有効になっているときはキャッシュをサポートしません。
InvalidOperationException	ExecuteSelect メソッドから返されたオブジェクトは DataSet ですが、その Tables コレクション内にテーブルがありません。 または EnablePaging プロパティが true に設定されていますが、StartRowIndexParameterName プロパティと MaximumRowsParameterName プロパティが設定されていません。

解説

ObjectDataSourceView クラスは、継承された ExecuteSelect メソッドを実装して、ビジネス オブジェクトを使用してデータを取得します。ページ開発者およびデータ連結コントロールの作成者は、ExecuteSelect メソッドを直接呼び出す代わりに、パブリックとして公開された Select メソッドを使用します。

指定したメソッドには、任意のメソッド シグネチャを設定できますが、ObjectDataSource コントロールの呼び出しに成功するには、このコントロールが次の表に記載されているいずれかの型を返す必要があります。

戻り値の型	アクション
IEnumerable	IEnumerable は、Select メソッドから返されます。
DataTable	DataView は DataTable を使用して作成され、Select メソッドから返されます。
DataSet	DataSet の最初の DataTable が抽出され、DataView が作成されて Select メソッドから返されます。
Object	このオブジェクトは、要素が 1 つの IEnumerable 内にラップされ、Select メソッドから返されます。

データ取得を実行する前に、OnSelecting メソッドが呼び出されて Selecting イベントが発生します。このイベントを処理してパラメータの値を調べ、操作の前に処理を実行できます。

選択操作を実行するために、ObjectDataSourceView コントロールはリフレクションを使用して、SelectMethod プロパティおよび SelectParameters コレクション内の任意の関連するパラメータで指定されたメソッドを呼び出し、実行します。操作が完了した後、OnSelected メソッドが呼び出されて Selected イベントが発生します。このイベントを処理することにより、戻り値とエラー コードを調べ、後処理を実行できます。

Select メソッドが DataSet オブジェクトを返し、キャッシュが有効な場合、ObjectDataSourceView は、操作中にキャッシュに対するデータの取得と保存を行います。キャッシュの作成、破棄、リフレッシュは、CacheDuration プロパティおよび CacheExpirationPolicy プロパティによって指定されたキャッシュ動作に基づいて行われます。

Select メソッドが DataSet オブジェクトを返し、FilterExpression プロパティが指定されている場合、指定された任意の FilterParameters プロパティとの組み合わせで評価され、評価の結果得られるフィルタがデータのリストに対して Select 操作中に適用されます。

選択された行数の戻り値の詳細については、Select のトピックを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ObjectDataSourceView クラス
ObjectDataSourceView メンバ
System.Web.UI.WebControls 名前空間
Select
SelectMethod
SelectCountMethod
OnSelecting
OnSelected
ObjectDataSource.Selecting イベント
ObjectDataSource.Selected イベント