SqlCeDataReader.Seek メソッド
メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。
SqlCeDataReader を、指定したパラメータに一致するインデックス値が存在するレコードに配置します。
Public Sub Seek( _
ByVal dbSeekOptions As DbSeekOptions, _ ByVal ParamArray index() As Object _)
[C#]
public void Seek(DbSeekOptionsdbSeekOptions, params object[] index);
[C++]
public: void Seek(DbSeekOptionsdbSeekOptions,Object* index __gc[]);
[JScript]
public function Seek(
dbSeekOptions : DbSeekOptions,index : Object[]);
パラメータ
dbSeekOptions
index
戻り値
例外
例外の種類 | 条件 |
---|---|
SqlCeException | 値が見つからないか、他のエラーが発生しました。 |
解説
このメソッドは、SELECT ステートメントの代わりに使用して、ベース テーブルから行をより速く取得することを目的としています。SELECT ステートメントの WHERE 句の代わりに Seek を使用して、インデックス値に基づいて、行をすばやく取得できます。たとえば、従業員 ID が 5 の従業員を取得する場合は、SELECT ステートメントを実行することもできますが、従業員 ID インデックスの値に 5 を指定して Seek を使用すると、パフォーマンスが大幅に向上します。
Seek を使用するためには、 CommandType を TableDirect にし、有効なテーブル名を CommandText に設定し、指定したベース テーブルの有効なインデックス名を IndexName に設定する必要があります。
Seek の使用後、 SqlCeDataReader は、残りの値をインデックス順に返します。 SetRange で範囲が指定された SqlCeDataReader で Seek を使用する場合、 Seek は、指定した範囲内の行だけを対象とします。詳細については、OLE DB のドキュメントの「IRowsetIndex::Seek」を参照してください。
必要条件
プラットフォーム: .NET Compact Framework - Windows CE .NET
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
SqlCeDataReader クラス | SqlCeDataReader メンバ | System.Data.SqlServerCe 名前空間