SqlCeCommand.SetRange-Methode

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

Schränkt die Menge der Zeilen ein, die vom SqlCeDataReader gelesen werden.

Public Sub SetRange( _
   ByVal dbRangeOptions As DbRangeOptions, _   ByVal startData() As Object, _   ByVal endData() As Object _)
[C#]
public void SetRange(DbRangeOptionsdbRangeOptions,object[] startData,object[] endData);
[C++]
public: void SetRange(DbRangeOptionsdbRangeOptions,Object* startData __gc[],Object* endData __gc[]);
[JScript]
public function SetRange(
   dbRangeOptions : DbRangeOptions,startData : Object[],endData : Object[]);

Parameter

• dbRangeOptions
  Die Optionen zum Angeben des Bereichs.
• startData
  Die Schlüsselwerte für den Anfang des Bereichs.
• endData
  Die Schlüsselwerte für das Ende des Bereichs.

Ausnahmen

Hinweise

Diese Methode soll eine schnellere Alternative zu einer SELECT-Anweisung zum Abrufen einer Menge an Zeilen aus einer Basistabelle darstellen. Anstelle einer WHERE-Klausel in einer SELECT-Anweisung kann SetRange dazu verwendet werden, eine Menge an Zeilen anhand ihrer Indexwerte schnell abzurufen. Um z. B. eine Reihe von Mitarbeitern mit einer Mitarbeiter-ID zwischen 1 und 5 abzurufen, könnten Sie eine SELECT-Anweisung ausführen. Die Leistung wird jedoch erheblich gesteigert, wenn Sie einen Bereich von 1 bis 5 für den Mitarbeiter-ID-Index festlegen.

Diese Methode kann nur verwendet werden, wenn CommandType auf TableDirect, CommandText auf einen gültigen Basistabellennamen und IndexName auf einen gültigen Indexnamen in der angegebenen Basistabelle festgelegt wird. Wenn SetRange verwendet wird, gibt der vom ExecuteReader zurückgegebene SqlCeDataReader nur die Zeilen zurück, deren Schlüsselwerte im angegebenen Index mit dem Bereich übereinstimmen.

Wenn Seek bei einem SqlCeDataReader verwendet wird, der über einen Bereich verfügt, wird Seek nur in Zeilen im angegebenen Bereich positioniert. Ausführliche Informationen über SetRange finden Sie unter dem Thema "IRowsetIndex::SetRange" in der OLE DB-Dokumentation.

Anforderungen

Plattformen: .NET Compact Framework - Windows CE .NET

.NET Framework-Sicherheit:

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

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