ObjectDataSourceView.ExecuteSelect(DataSourceSelectArguments) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 リスト。
例外
ExecuteSelect(DataSourceSelectArguments) メソッドに渡される arguments
は、データを取得するときに、取得したデータに対するページングまたは並べ替えを有効にするには、データ ソースで追加の作業が必要であることを指定しますが、データ ソース コントロールは、要求された機能をサポートしていません。
- または -
ExecuteSelect(DataSourceSelectArguments) メソッドから返されたオブジェクトが DataSet または DataTable でなく、かつキャッシュが有効になっています。 DataSet コントロールに対して、DataTable オブジェクトと ObjectDataSourceView オブジェクトのみがキャッシュできます。
- または -
キャッシュとクライアント偽装の両方が有効になっています。 ObjectDataSource は、クライアント偽装が有効になっているときはキャッシュをサポートしません。
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。
適用対象
こちらもご覧ください
.NET