SqlDataSource.Select メソッド

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

SqlDataSource.Select メソッド

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

SelectCommand SQL 文字列、および SelectParameters コレクション内の任意のパラメータを使用して、基になるデータベースからデータを取得します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Function Select (
 _
    arguments As DataSourceSelectArguments _
) As IEnumerable

Visual Basic (使用法)

Dim instance As SqlDataSource
Dim arguments As DataSourceSelectArguments
Dim returnValue As IEnumerable

returnValue = instance.Select(arguments)

C#

public IEnumerable Select (
    DataSourceSelectArguments arguments
)

C++

public:
IEnumerable^ Select (
    DataSourceSelectArguments^ arguments
)

J#

public IEnumerable Select (
    DataSourceSelectArguments arguments
)

JScript

public function Select (
    arguments : DataSourceSelectArguments
) : IEnumerable

パラメータ

arguments

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

戻り値
データ行の IEnumerable リスト。

例外

例外の種類	条件
InvalidOperationException	SqlDataSource が基になるデータ ソースとの接続を確立できません。

解説

Select メソッドは、DataSourceMode プロパティが DataSet 値に設定されている場合に、DataView オブジェクトを返し、DataSourceMode プロパティが DataReader 値に設定されている場合は、IDataReader オブジェクトを返します。データの読み取りが終わったら、IDataReader オブジェクトを閉じます。

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

Select 操作の完了後、OnSelected メソッドが呼び出されて Selected イベントが発生します。このイベントを処理することにより、戻り値とエラー コードを調べ、後処理を実行できます。

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

セキュリティに関するメモ
Microsoft Windows 認証の下でクライアント偽装を使用している場合、最初のユーザーがデータにアクセスすると、データがキャッシュされます。別のユーザーが同じデータを要求した場合、データはキャッシュから取得されます。データベースに対してもう一度呼び出しを行っても、ユーザーのデータへのアクセスを確認するためにデータ取得を実行することはありません。複数ユーザーによるデータへのアクセスが想定され、データが取得されるたびにデータベースのセキュリティ構成を使用して検証する場合は、キャッシュを使用しないでください。

DataSourceMode が DataSet 値に設定されていて、FilterExpression プロパティが指定されている場合、指定された任意の FilterParameters プロパティと組み合わせて評価され、評価の結果得られるフィルタがデータのリストに対して Select 操作中に適用されます。

Select メソッドは、SqlDataSource コントロールに関連付けられた SqlDataSourceView の Select メソッドに処理を代行させます。データ取得操作を実行するために、SqlDataSourceView は、SelectCommand テキストと関連する任意の SelectParameters を使用して、DbCommand オブジェクトを構築し、基になるデータベースに対して DbCommand を実行します。

プラットフォーム

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

参照

関連項目
SqlDataSource クラス
SqlDataSource メンバ
System.Web.UI.WebControls 名前空間
SelectCommand
SelectParameters