Bde.DBTables.TTable.SetRange
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);
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | Bde.DBTables.pas Bde.DBTables.hpp |
Bde.DBTables | TTable |
Beschreibung
Setzt die Anfangs- und Endwerte eines Bereichs und übernimmt ihn.
Mit SetRange können Sie einen Bereich festlegen und ihn auf die Datenmenge übernehmen. Dabei ersetzt der neue Bereich den aktuell angewendeten Bereich (falls zutreffend).
StartValues bezeichnet die Feldwerte, die den ersten Datensatz im Bereich identifizieren. StartValues_Size gibt den Index des letzten Wertes von StartValues an (Gesamtanzahl der gegebenen Werte minus 1).
EndValues bezeichnet die Feldwerte, die den letzten Datensatz im Bereich identifizieren. EndValues_Size gibt den Index des letzten Wertes von EndValues an (Gesamtanzahl der gegebenen Werte minus 1).
SetRange kombiniert die Funktionalität von SetRangeStart, SetRangeEnd und ApplyRange in einem einzelnen Prozeduraufruf. SetRange führt die folgenden Operationen aus:
- Setzt die Datenmenge auf den Status dsSetKey.
- Löscht alle zuvor angegebenen Anfangs- und Endwerte des Bereichs.
- Setzt die Anfangs- und Endwerte des Bereichs.
- Übernimmt den Bereich auf die Datenmenge.
Enthält StartValues oder EndValues weniger Elemente als die Felderanzahl im aktuellen Index, wird NULL für die verbleibenden Einträge verwendet.
Nach einem Aufruf der Methode SetRange bleibt der Cursor auf dem ersten Datensatz im Bereich. Wenn zwei Aufrufe an SetRange nacheinander mit den selben Parametern vorgenommen werden, wird jedoch der zweite interne Aufruf optimiert.
Hinweis: In Paradox- oder dBASE-Tabellen funktioniert SetRange nur für indizierte Felder. In SQL-Datenbanken funktioniert SetRange auch für alle in der Eigenschaft IndexFieldNames angegebenen Spalten.