FireDAC.Comp.DataSet.TFDMasterDataLink.DisableDelayedScroll
Delphi
procedure DisableDelayedScroll;
C++
void __fastcall DisableDelayedScroll();
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | FireDAC.Comp.DataSet.pas FireDAC.Comp.DataSet.hpp |
FireDAC.Comp.DataSet | TFDMasterDataLink |
Beschreibung
Deaktiviert die verzögerte Aktualisierung der Detaildatenmenge.
Mit der Methode DisableDelayedScroll der MasterLink-Eigenschaft der Detaildatenmenge deaktivieren Sie die verzögerte Aktualisierung der Detaildatenmenge. Stattdessen wird die sofortige Aktualisierung verwendet. Die Methode hat nur Auswirkungen, wenn eine verzögerte Aktualisierung aktiviert ist.
Die Methode ist in Anwendungscode nützlich, in dem die Hauptdatenmenge durchlaufen werden muss und zudem die Datensätze der Detaildatenmenge gelesen werden müssen. Außerdem verfügt die Detaildatenmenge über ein TFDDataSet-Objekt als Wert. Eigenschaftswert von FetchOptions.DetailDelay > 0. Dies ermöglicht die Kombination der verzögerten Aktualisierung der Detaildatenmenge mit der synchronisierten Aktualisierung im Code, wenn der Benutzer in der Hauptdatenmenge im GUI einen Bildlauf durchführt.
Mit der Methode EnableDelayedScroll können Sie die verzögerte Aktualisierung der Detaildatenmenge wieder aktivieren. Die Methodenaufrufe von DisableDelayedScroll/EnableDelayedScroll müssen paarweise erfolgen und können verschachtelt sein. FireDAC verfolgt anhand eines Zählers die verschachtelten Aufrufe von DisableDelayedScroll/EnableDelayedScroll. Der oberste Aufruf der Methode DisableDelayedScroll synchronisiert die Detaildatenmenge mit der Hauptdatenmenge, falls sie nicht bereits synchronisiert sind.
Mit der Methode Synchronize synchronisieren Sie die Detaildatenmenge mit der Hauptdatenmenge.
Beispiel
qDetail.MasterLink.DisableDelayedScroll;
try
qMaster.First;
while not qMaster.Eof do begin
if qMaster.Fields[i].AsInteger = 100 then begin
// read qDetail dataset - it is synchronized with qMaster
end;
qMaster.Next;
end;
finally
qDetail.MasterLink.EnableDelayedScroll;
end;