Datasnap.DBClient.TCustomClientDataSet.SetRange

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SetRange(const StartValues, EndValues: array of const);

C++

void __fastcall SetRange(const System::TVarRec *StartValues, const int StartValues_High, const System::TVarRec *EndValues, const int EndValues_High);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Datasnap.DBClient.pas
Datasnap.DBClient.hpp
Datasnap.DBClient TCustomClientDataSet

Beschreibung

Dient der Einstellung der Anfangs- und Endwerte eines Bereichs und aktiviert den Bereich.

Mit SetRange können Sie einen Bereich definieren und für die Datenmenge aktivieren. Der neue Bereich ersetzt gegebenenfalls den aktuell definierten Bereich.

StartValues bezeichnet die Feldwerte, die den ersten Datensatz im Bereich identifizieren. In C++ ist StartValues_Size der Index des letzten Wertes im Array StartValues.

EndValues bezeichnet die Feldwerte, die den letzten Datensatz im Bereich identifizieren. In C++ ist EndValues_Size der Index des letzten Wertes im Array EndValues.

SetRange kombiniert die Funktionalität von SetRangeStart, SetRangeEnd und ApplyRange in einem einzelnen Prozeduraufruf SetRange führt die folgenden Operationen aus:

Die Datenmenge erhält den Status dsSetKey.

Zuvor angegebene Werte für Bereichsanfang und Bereichsende werden gelöscht.

Neue Werte für Bereichsanfang und Bereichsende werden festgelegt.

Der Bereich wird für die Datenmenge aktiviert.

Nach einem Aufruf der Methode SetRange befindet sich der Cursor auf dem ersten Datensatz im Bereich.

Enthält StartValues oder EndValues weniger Elemente als der aktuelle Index Felder, wird für die verbleibenden Einträge NULL verwendet.

Siehe auch