ObjectDataSource.Select メソッド

  • リファレンス

定義

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

SelectMethod コレクション内のパラメーターを持つ SelectParameters プロパティで識別されるメソッドを呼び出して、基になるデータ ストレージからデータを取得します。

public:
 System::Collections::IEnumerable ^ Select();
public System.Collections.IEnumerable Select ();
member this.Select : unit -> System.Collections.IEnumerable
Public Function Select () As IEnumerable

戻り値

IEnumerable

データ行の IEnumerable リスト。

例

コード例については、「ObjectDataSource」を参照してください。

注釈

指定したメソッドには任意のメソッド シグネチャを含めることができますが、コントロールが正常に呼び出すには、次の表 ObjectDataSource に示す型のいずれかを返すか、派生させる必要があります。

の戻り値の型 : 操作
IEnumerable IEnumerableは メソッドによってSelect返されます。
DataTable DataViewは を使用してDataTable作成され、 メソッドによってSelect返されます。
DataView DataViewは メソッドによってSelect返されます。
DataSet の最初 DataTable の DataSet が抽出され、 DataView が作成され、 Select メソッドによって返されます。
Object オブジェクトは 1 要素 IEnumerable コレクションでラップされ、 メソッドによって Select 返されます。

プロパティで SelectMethod 識別されるメソッドには、インスタンス メソッドまたは static (Shared Visual Basic の場合は ) メソッドを指定できます。 インスタンス メソッドの場合、ビジネス オブジェクトは、プロパティで指定されたメソッドが呼び出されるたびに作成および破棄されます。ただし、 プロパティで SelectMethod 指定されたメソッドと、 プロパティで SelectMethod 指定 SelectCountMethod されたメソッドを呼び出すために同じインスタンスが使用される点が除きます。 メソッドは Select インターフェイスを IEnumerable 返します。 ただし、キャッシュとフィルター処理のシナリオを有効にするには、戻り値を オブジェクトにする DataSet 必要があります。 クラスは インターフェイスをDataSetIEnumerable実装しませんが、 コントロールはObjectDataSource、 を実装する既定DataViewのコントロールを自動的にIEnumerable抽出します。

操作が Select 実行される前に、 メソッドが OnSelecting 呼び出されてイベントが発生します Selecting 。 イベントを Selecting 処理して、パラメーターの値を調べ、操作の前に前処理を Select 実行できます。 データ取得操作を実行するために、オブジェクトは ObjectDataSourceView リフレクションを使用して、 プロパティによって識別される オブジェクトのインスタンスを TypeName 作成します。 その後、関連付けられているSelectParametersプロパティを使用して、 プロパティによってSelectMethod識別されるメソッドを呼び出します。 操作が Select 完了すると、 メソッドが OnSelected 呼び出されてイベントが発生します Selected 。 イベントを Selected 処理して、戻り値、出力パラメーター、例外を調べ、後処理を実行できます。

プロパティが SelectMethod 、、または DataView オブジェクトをDataSet返し、キャッシュが有効になっている場合、 は からデータを取得し、ObjectDataSource操作中にキャッシュにデータをSelect保存します。 DataTable キャッシュは、 プロパティと CacheExpirationPolicy プロパティの組み合わせCacheDurationで指定されたキャッシュ動作に基づいて作成、破棄、または更新されます。

プロパティが SelectMethod または オブジェクトをDataSet返しFilterExpression、プロパティが指定されている場合は、指定されたFilterParametersプロパティで評価され、結果のフィルターが操作中Selectにデータの一覧DataTableに適用されます。

メソッドは Select 、 コントロールに Select 関連付けられている の ObjectDataSourceView メソッドに ObjectDataSource デリゲートします。

パラメーターのマージ、オブジェクトの有効期間、およびメソッド解決の詳細については、「」を参照してください SelectMethod。

データ バインド コントロール

コントロールが ObjectDataSource データ バインド コントロール (コントロールなど GridView ) に関連付けられている場合、ページ コードから メソッドを Select 呼び出す必要はありません。 メソッドは Select 、代わりにデータ バインド コントロールによって直接呼び出されます。

適用対象

こちらもご覧ください