Freigeben über


SqlCeDataReader.Seek-Methode

Hinweis: Dieser Namespace oder Member bzw. diese Klasse wird nur von .NET Framework, Version 1.1, unterstützt.

Platziert den SqlCeDataReader im Datensatz mit indizierten Werten, die den angegebenen Parametern entsprechen.

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[]);

Parameter

  • dbSeekOptions

  • index

Rückgabewert

Ausnahmen

Ausnahmetyp Bedingung
SqlCeException Der Wert wurde nicht gefunden, oder ein anderer Fehler ist aufgetreten.

Hinweise

Diese Methode soll eine schnellere Alternative zu einer SELECT-Anweisung zum Abrufen einer Zeile aus einer Basistabelle darstellen. Anstelle einer WHERE-Klausel in einer SELECT-Anweisung kann Seek dazu verwendet werden, eine Zeile schnell anhand ihres Indexwertes abzurufen. Zum Abrufen des Mitarbeiters mit der Mitarbeiter-ID 5 könnten Sie z. B. eine SELECT-Anweisung ausführen. Die Leistung wird jedoch erheblich gesteigert, wenn Sie Seek mit dem Wert 5 für den Mitarbeiter-ID-Index verwenden.

Seek kann nur verwendet werden, wenn CommandType auf TableDirect, CommandText auf einen gültigen Namen für eine Basistabelle und IndexName auf einen gültigen Indexnamen in der angegebenen Basistabelle festgelegt ist.

Nach der Verwendung von Seek gibt SqlCeDataReader die übrigen Zeilen in ihrer Indexreihenfolge zurück. Wenn Seek bei einem SqlCeDataReader verwendet wird, dessen Bereich durch SetRange angegeben wird, wird Seek nur in Zeilen innerhalb dieses Bereichs positioniert. Weitere Informationen erhalten Sie unter dem Thema "IRowsetIndex::Seek" in der OLE DB-Dokumentation.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

Siehe auch

SqlCeDataReader-Klasse | SqlCeDataReader-Member | System.Data.SqlServerCe-Namespace