Data.DB.TDataSet.Refresh

Übergeordnet: TDataSet

Delphi

procedure Refresh;

C++

void __fastcall Refresh();

Inhaltsverzeichnis

1 Eigenschaften
2 Beschreibung
- 2.1 Siehe auch
- 2.2 Codebeispiele

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).