AccessDataSourceView.ExecuteSelect(DataSourceSelectArguments) メソッド

  • リファレンス

定義

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

SelectCommand プロパティの SQL 文字列と、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。

例外

InvalidOperationException

DataFile プロパティが null または空の文字列 ("") です。

NotSupportedException

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

注釈

オブジェクトは AccessDataSourceView 、 メソッドを ExecuteSelect オーバーライドして、データを取得する DataFile 前に、関連付けられた AccessDataSource コントロールの プロパティが確実に設定されるようにします。

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

データ取得を実行するために、オブジェクトはAccessDataSourceViewテキストと関連付けられているSelectParametersプロパティをSelectCommand使用してオブジェクトをビルドIDbCommandします。 次に、 オブジェクトは AccessDataSourceView 、基になるデータ ストレージに対して オブジェクトを実行 IDbCommand します。 操作が完了すると、 メソッドが OnSelected 呼び出されてイベントが発生します Selected 。 イベントを Selected 処理して、戻り値とエラー コードを調べ、後処理を実行できます。

プロパティが DataSourceMode 値に DataSet 設定され、キャッシュが有効になっている場合、 AccessDataSourceView は からデータを取得し、データ取得操作中にキャッシュにデータを保存します。 キャッシュは、 プロパティと CacheExpirationPolicy プロパティの組み合わせCacheDurationで指定されたキャッシュ動作に基づいて作成、破棄、または更新されます。

プロパティが DataSourceMode 値に DataSet 設定され FilterExpression 、プロパティが指定されている場合、 DataSourceMode プロパティは指定されたプロパティと共に FilterParameters 評価され、結果のフィルターは操作中 Select にデータの一覧に適用されます。

適用対象

こちらもご覧ください