SqlDataSourceView.ExecuteSelect メソッド
アセンブリ: System.Web (system.web.dll 内)

Protected Friend Overrides Function ExecuteSelect ( _ arguments As DataSourceSelectArguments _ ) As IEnumerable
Dim arguments As DataSourceSelectArguments Dim returnValue As IEnumerable returnValue = Me.ExecuteSelect(arguments)
protected public: virtual IEnumerable^ ExecuteSelect ( DataSourceSelectArguments^ arguments ) override
protected internal override function ExecuteSelect ( arguments : DataSourceSelectArguments ) : IEnumerable
戻り値
データ行の IEnumerable リスト。


SqlDataSourceView クラスは、継承された ExecuteSelect メソッドを実装して、データベースからデータを取得します。ページ開発者およびデータ連結コントロールの作成者は、ExecuteSelect メソッドを直接呼び出す代わりに、パブリックとして公開された Select メソッドを使用します。
データ取得を実行する前に、OnSelecting メソッドが呼び出されて Selecting イベントが発生します。このイベントを処理してパラメータの値を調べ、データ取得の前に処理を実行できます。
操作を実行するために、SqlDataSourceView オブジェクトは、SelectCommand テキストおよび関連する任意の SelectParameters を使用して、DbCommand オブジェクトを構築し、基になるデータベースに対してこのオブジェクトを実行します。操作が完了した後、OnSelected メソッドが呼び出されて Selected イベントが発生します。このイベントを処理することにより戻り値 (エラー コード) を調べ、後処理を実行できます。
ExecuteSelect メソッドは、DataSourceMode が DataSet に設定されている場合には DataView オブジェクトを返し、DataSourceMode が DataReader に設定されている場合には IDataReader オブジェクトを返します。データの読み取りが終わったら、IDataReader オブジェクトを閉じます。
DataSourceMode が DataSet に設定されていてキャッシュが有効な場合、SqlDataSourceView は、データの操作中にキャッシュからデータを取得したり、キャッシュにデータを保存したりします。キャッシュの作成、破棄、リフレッシュは、CacheDuration プロパティおよび CacheExpirationPolicy プロパティによって指定されたキャッシュ動作に基づいて行われます。
![]() |
---|
Windows 認証でクライアント偽装を使用している場合、最初のユーザーがデータにアクセスすると、データがキャッシュされます。別のユーザーが同じデータを要求した場合、データはキャッシュから取得されます。ユーザーのデータへのアクセスを確認するためにデータベースに対してもう一度呼び出しを行うことにより、データ取得が実行されることはありません。複数のユーザーがデータにアクセスすることが想定され、データが取得されるたびにデータベースのセキュリティ構成を使用して検証することを希望する場合は、キャッシュを使用しないでください。 |
DataSourceMode が DataSet に設定されていて、FilterExpression が指定されている場合、指定された任意の FilterParameters との組み合わせで評価され、評価の結果得られるフィルタがデータ取得操作中にデータのリストに対して適用されます。

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- SqlDataSourceView.ExecuteSelect メソッドのページへのリンク