Data.Win.ADODB.TCustomADODataSet.FilterGroup

Übergeordnet: TCustomADODataSet

Delphi

property FilterGroup: TFilterGroup read GetFilterGroup write SetFilterGroup;

C++

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

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
property	public	Data.Win.ADODB.pas Data.Win.ADODB.hpp	Data.Win.ADODB	TCustomADODataSet

Beschreibung

Filtert ein Recordset-Objekt nach dem Aktualisierungsstatus der Datensätze.

Mit FilterGroup können Sie das Recordset-Objekt der ADO-Datenmenge filtern. Die Datenmenge muss sich dabei im Batch-Aktualisierungsmodus befinden. Die Datensätze werden anhand ihres Aktualisierungsstatus gefiltert. Setzen Sie dazu FilterGroup auf die entsprechende TFilterGroup-Konstante. Wenn Sie beispielsweise den Wert fgPendingRecords zuweisen, werden nur Datensätze angezeigt, die seit der letzten Aktualisierung geändert wurden.

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

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

Sie können FilterGroup nur verwenden, wenn die Eigenschaft LockType den Wert ltBatchOptimistic (eine Vorbedingung für Batch-Aktualisierungen) und die Eigenschaft Filtered den Wert true hat. In einer gefilterten Datenmenge kann der Status der einzelnen Datensätze mithilfe der Eigenschaft RecordStatus überprüft werden.

Es stehen folgende TFilterGroup-Konstanten zur Verfügung:

Konstante	Bedeutung
fgUnassigned	Die Datensätze werden nicht gefiltert. Diese Konstante wird intern von der ADO-Datenmengenkomponente verwendet.
fgNone	Der aktuelle Filter wird deaktiviert, und es werden wieder alle Datensätze angezeigt. Das gleiche Ergebnis erhalten Sie, wenn Sie Filtered auf false setzen.
fgPendingRecords	Es werden nur die Datensätze angezeigt, deren Änderungen nicht eingetragen (mit UpdateBatch) oder abgebrochen (CancelBatch) wurden.
fgAffectedRecords	Es werden nur die Datensätze angezeigt, die bei der letzten Aktualisierung eingetragen wurden.
fgFetchedRecords	Es werden nur die Datensätze im aktuellen Aktualisierungspuffer angezeigt. Diese Datensätze wurden beim letzten Abrufen aus der Datenbank eingelesen.
fgPredicate	Es werden nur die gelöschten Datensätze angezeigt.
fgConflictingRecords	Es werden nur die Datensätze angezeigt, die bei der letzten Aktualisierung aufgrund von Fehlern nicht eingetragen werden konnten.