Data.DB.TDataSet.Refresh

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Refresh;

C++

void __fastcall Refresh(void);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
Data.DB.pas
Data.DB.hpp
Data.DB TDataSet

Beschreibung

Aktualisiert eine Datenmenge durch erneutes Abrufen der Daten aus der Datenbank.

Mit Refresh können Sie sicherstellen, dass die neuesten Daten aus einer Datenbank verwendet werden. Wird beispielsweise in einer Anwendung der Filter einer Datenmenge deaktiviert, sollte anschließend sofort Refresh aufgerufen werden, damit alle Datensätze in der Datenmenge angezeigt werden und nicht nur diejenigen, die mit der Filterbedingung übereinstimmen.

Anmerkung:  Die Methode Refresh funktioniert nicht bei allen von TDataSet abgeleiteten Klassen. Insbesondere TQuery-Komponenten unterstützen Refresh nicht, wenn die Abfrage nicht "live" ist. Um ein statisches TQuery-Objekt zu aktualisieren, schließen und öffnen Sie die Datenmenge.

TDataSet generiert vor der Datensatzaktualisierung ein BeforeRefresh- und nach der Aktualisierung ein AfterRefresh-Ereignis.

Anmerkung:  Bei den meisten Datenmengen bleibt die aktuelle Datensatzposition erhalten, wenn eine Aktualisierung durchgeführt wird. Dies ist jedoch nicht immer möglich. Es könnte beispielsweise sein, dass der aktuelle Datensatz zwischenzeitlich durch einen Benutzer auf dem Server gelöscht wurde. Unidirektionale Datenmengen haben keinen Mechanismus, der nach der Aktualisierung wieder auf den aktuellen Datensatz positioniert. Bei diesen Datenmengen ist nach einer Aktualisierung immer der erste Datensatz aktiv.

Warnung:  Unidirektionale Datenmengen werden durch Schließen und erneutes Öffnen des Cursors aktualisiert. Dies zu kann zu unerwünschten Nebeneffekten führen (z.B. aufgrund einer Ereignisbehandlungsroutine für BeforeClose, AfterClose, BeforeOpen oder AfterOpen).

Siehe auch

Codebeispiele