Datasnap.DBClient.TCustomClientDataSet.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);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
procedure function |
public | Datasnap.DBClient.pas Datasnap.DBClient.hpp |
Datasnap.DBClient | TCustomClientDataSet |
Description
Définit et applique les valeurs de départ et de fin d'un intervalle.
La méthode SetRange permet de spécifier un intervalle et de l'appliquer à l'ensemble de données. Le cas échéant, le nouvel intervalle remplace celui actuellement spécifié.
StartValues indique les valeurs de champ désignant le premier enregistrement de l'intervalle. Dans C++, StartValues_Size spécifie l'indice de la dernière valeur du tableau StartValues.
EndValues indique les valeurs de champ désignant le dernier enregistrement de l'intervalle. Dans C++, EndValues_Size spécifie l'index de la dernière valeur du tableau EndValues.
SetRange combine les fonctionnalités de SetRangeStart, SetRangeEnd et ApplyRange en un seul appel de procédure. SetRange effectue les opérations suivantes :
1. Placer l'ensemble de données dans le mode dsSetKey.
2. Effacer les valeurs de début et de fin d'intervalle existantes.
3. Définir les valeurs de début et de fin d'intervalle.
4. Appliquer l'intervalle à l'ensemble de données.
Lorsque SetRange est appelée, le curseur se positionne sur le premier enregistrement de l'intervalle.
Si StartValues ou EndValues contient moins d'éléments qu'il n'y a de champs dans l'index en cours, les entrées restantes sont définies à NULL.