Data.Win.ADODB.TCustomADODataSet.FilterGroup

Aller au parent : TCustomADODataSet

Delphi

property FilterGroup: TFilterGroup read GetFilterGroup write SetFilterGroup;

C++

__property TFilterGroup FilterGroup = {read=GetFilterGroup, write=SetFilterGroup, nodefault};

Propriétés

Type	Visibilité	Source	Unité	Parent
property	public	Data.Win.ADODB.pas Data.Win.ADODB.hpp	Data.Win.ADODB	TCustomADODataSet

Description

Filtre un ensemble d'enregistrements en se basant sur l'état de mise à jour d'une ligne.

Utilisez FilterGroup pour filtrer l'ensemble d'enregistrements affiché par un composant ensemble de données ADO. Ce filtrage suppose que l'ensemble de données est en mode mise à jour groupée, les lignes étant filtrées en fonction de leur mise à jour. Affectez à FilterGroup une constante de type TFilterGroup pour ne filtrer de l'ensemble de données que les lignes correspondant à cet état de mise à jour groupée. Par exemple, affectez la valeur fgPendingRecords à FilterGroup pour n'afficher que les lignes modifiées depuis la dernière application des mises à jour.

if (ADODataSet1.LockType = ltBatchOptimistic) then begin
ADODataSet1.Filtered := True;
ADODataSet1.FilterGroup := fgPendingRecords;
end;

if (ADODataSet1->LockType == ltBatchOptimistic)
{
ADODataSet1->Filtered = true;
ADODataSet1->FilterGroup = fgPendingRecords;
};

Si vous voulez utiliser FilterGroup pour filtrer les lignes selon leur type de mise à jour, vérifiez que la propriété LockType a la valeur ltBatchOptimistic (ce qui est indispensable pour les mises à jour groupées) et que la propriété Filtered a la valeur true. Dans un ensemble de données filtré, vous pouvez examiner individuellement l'état de mise à jour des lignes en utilisant la propriété RecordStatus.

Le type TFilterGroup est constitué des constantes suivantes :

Type de filtrage de groupe	Signification
fgUnassigned	Spécifie une absence de filtrage. Cette constante est utilisée de manière interne par le composant ensemble de données ADO.
fgNone	Supprime le filtrage en cours, toutes les lignes sont visibles. On obtient le même résultat en affectant la valeur false à la propriété Filtered.
fgPendingRecords	Filtre utilisé pour ne montrer que les lignes modifiées dont les modifications n'ont pas été appliquées (méthode UpdateBatch) ou annulées (CancelBatch).
fgAffectedRecords	Filtre utilisé pour ne montrer que les lignes affectées par la dernière mise à jour.
fgFetchedRecords	Filtre utilisé pour ne montrer que les lignes placées dans le cache de mises à jour en cours. C'est le résultat du dernier appel pour lire des lignes dans la base de données.
fgPredicate	Filtre utilisé pour ne montrer que les lignes supprimées.
fgConflictingRecords	Filtre utilisé pour ne montrer que les lignes modifiées dont les modifications n'ont pu être appliquées car il y a eu des erreurs quand cela a été tenté.