次の方法で共有


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 を使用するためには、 CommandTypeTableDirect にし、有効なテーブル名を CommandText に設定し、指定したベース テーブルの有効なインデックス名を IndexName に設定する必要があります。

Seek の使用後、 SqlCeDataReader は、残りの値をインデックス順に返します。 SetRange で範囲が指定された SqlCeDataReaderSeek を使用する場合、 Seek は、指定した範囲内の行だけを対象とします。詳細については、OLE DB のドキュメントの「IRowsetIndex::Seek」を参照してください。

必要条件

プラットフォーム: .NET Compact Framework - Windows CE .NET

.NET Framework セキュリティ:

参照

SqlCeDataReader クラス | SqlCeDataReader メンバ | System.Data.SqlServerCe 名前空間