ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

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

protected public:
 override System::Collections::IEnumerable ^ ExecuteSelect(System::Web::UI::DataSourceSelectArguments ^ arguments);
protected internal override System.Collections.IEnumerable ExecuteSelect (System.Web.UI.DataSourceSelectArguments arguments);
override this.ExecuteSelect : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable
Protected Friend Overrides Function ExecuteSelect (arguments As DataSourceSelectArguments) As IEnumerable

パラメーター

arguments
DataSourceSelectArguments

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

戻り値

IEnumerable

データ行の IEnumerable リスト。

例外

NotSupportedException

ExecuteSelect(DataSourceSelectArguments) メソッドに渡される arguments は、データを取得するときに、取得したデータに対するページングまたは並べ替えを有効にするには、データ ソースで追加の作業が必要であることを指定しますが、データ ソース コントロールは、要求された機能をサポートしていません。

- または -

ExecuteSelect(DataSourceSelectArguments) メソッドから返されたオブジェクトが DataSet または DataTable でなく、かつキャッシュが有効になっています。 DataSet コントロールに対して、DataTable オブジェクトと ObjectDataSourceView オブジェクトのみがキャッシュできます。

- または -

キャッシュとクライアント偽装の両方が有効になっています。 ObjectDataSource は、クライアント偽装が有効になっているときはキャッシュをサポートしません。

InvalidOperationException

ExecuteSelect(DataSourceSelectArguments) メソッドから返されたオブジェクトは DataSet ですが、その Tables コレクション内にテーブルがありません。

- または -

EnablePaging プロパティが true に設定されていますが、StartRowIndexParameterName プロパティと MaximumRowsParameterName プロパティが設定されていません。

注釈

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

指定したメソッドは任意のメソッド シグネチャを持つことができますが、正常に呼び出すには、次の表に示すコントロールの型 ObjectDataSource のいずれかを返す必要があります。

の戻り値の型 : 操作
IEnumerable IEnumerableは メソッドによってSelect返されます。
DataTable DataViewは を使用してDataTable作成され、 Select メソッドによって返されます。
DataSet の最初 DataTable の DataSet が抽出され、 DataView が作成され、 Select メソッドによって返されます。
Object オブジェクトは 1 要素 IEnumerable でラップされ、 メソッドによって Select 返されます。

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

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

メソッドが オブジェクトをSelectDataSet返し、キャッシュが有効になっている場合、 ObjectDataSourceView は からデータを取得し、操作中にデータをキャッシュに保存します。 キャッシュは、 プロパティと CacheExpirationPolicy プロパティのCacheDuration組み合わせによって指定されたキャッシュ動作に基づいて作成、破棄、または更新されます。

メソッドがオブジェクトをSelectDataSet返しFilterExpression、プロパティが指定されている場合は、指定されたFilterParametersプロパティと共に評価され、結果のフィルターが操作中にデータの一覧にSelect適用されます。

選択した行数を返す方法については、「」を参照してください Select。

適用対象

こちらもご覧ください