AccessDataSourceView.ExecuteSelect メソッド

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

AccessDataSourceView.ExecuteSelect メソッド

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

SelectCommand プロパティの SQL 文字列と、SelectParameters コレクションの任意のパラメータを使用して、基になるデータ ストレージからデータを取得します。

名前空間: 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。

例外

例外の種類	条件
InvalidOperationException	DataFile プロパティが null 参照 (Visual Basic では Nothing) または空の文字列 ("") です。
NotSupportedException	ExecuteSelect メソッドに渡される arguments は、データを取得するときに、取得したデータに対するページングまたは並べ替えを有効にするには、データ ソースで追加の作業が必要であることを指定しますが、データ ソース コントロールは、要求された機能をサポートしていません。

解説

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

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

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

DataSourceMode プロパティが DataSet 値に設定されていてキャッシュが有効な場合、AccessDataSourceView は、データ取得操作中にキャッシュに対してデータの取得および保存を行います。キャッシュの作成、破棄、リフレッシュは、CacheDuration プロパティおよび CacheExpirationPolicy プロパティによって指定されたキャッシュ動作に基づいて行われます。

DataSourceMode プロパティが DataSet 値に設定されていて、FilterExpression プロパティが指定されている場合、DataSourceMode プロパティは、指定された任意の FilterParameters プロパティとの組み合わせで評価され、評価の結果得られるフィルタがデータのリストに対して 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

参照

関連項目
AccessDataSourceView クラス
AccessDataSourceView メンバ
System.Web.UI.WebControls 名前空間
AccessDataSource クラス
AccessDataSource.DataFile プロパティ
ExecuteSelect