FireDAC.Comp.DataSet.TFDDataSet.SetRange

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure SetRange(const AStartValues, AEndValues: array of const;  AStartExclusive: Boolean = False; AEndExclusive: Boolean = False);

C++

void __fastcall SetRange(const System::TVarRec *AStartValues, const int AStartValues_High, const System::TVarRec *AEndValues, const int AEndValues_High, bool AStartExclusive = false, bool AEndExclusive = false);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FireDAC.Comp.DataSet.pas
FireDAC.Comp.DataSet.hpp
FireDAC.Comp.DataSet TFDDataSet

Beschreibung

Legt die Anfangs- und Endwerte eines Bereichs fest und übernimmt diese.

Mit SetRange legen Sie Anfangs- und Endwerte eines Bereichs für die Datenmenge fest und übernehmen den Bereich.

AStartValues legt den Anfang des Bereichs der indizierten Feldwerte fest.AEndValues legt das Ende des Bereichs der indizierten Feldwerte fest.SetRange führt Folgendes aus:

  1. Versetzt die Datenmenge in den Status dsSetKey.
  2. Löscht zuvor angegebene Werte für den Bereichsanfang und das Bereichsende.
  3. Legt neue Werte für den Bereichsanfang und das Bereichsende fest.
  4. Übernimmt den Bereich für die Datenmenge.

Wenn sich der aktuelle Datensatz der Datenmenge in einem neuen Bereich befindet, dann wird er nach einem Aufruf von SetRange zum aktuellen Datensatz. Ansonsten wird die aktuelle Position auf den ersten Datensatz in dem Bereich gesetzt.

Wenn AStartValues oder AEndValues weniger Elemente als der aktuelle Index Felder enthält, wird für die verbleibenden Einträge NULL festgelegt.

Beispiel

FDQuery1.IndexFieldNames := 'CUST_NO';  
FDQuery1.SetRange([100], [200]);

Siehe auch