Data.DB.TDataSet.Append

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure Append;

C++

void __fastcall Append();

Eigenschaften

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

Beschreibung

Fügt einen neuen, leeren Datensatz am Ende der Datenmenge hinzu.

Bei Datenmengen, die eine Bearbeitung erlauben, können Sie mit Append folgende Aktionen durchführen:

1. Einen neuen leeren Datensatz am Ende der Datenmenge öffnen.

2. Der neue wird zum aktiven Datensatz gemacht.

Nach dem Aufruf von Append kann die Anwendung den Benutzern die Eingabe von Daten in die Felder des neuen Datensatzes ermöglichen. Anschließend können die Änderungen mit Post in die Datenbank oder das Änderungsprotokoll eingetragen werden (Client-Datenmengen können die im Protokoll enthaltenen Änderungen durch einen Aufruf von ApplyUpdates in die Datenbank schreiben). Ein neu hinzugefügter Datensatz wird auf eine von drei Arten in die Datenbank eingetragen:

Bei indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der Position in die Datenmenge eingefügt, die sich anhand seines Index ergibt.

Bei nicht indizierten Paradox- und dBASE-Tabellen wird der Datensatz am Ende der Datenmenge hinzugefügt.

Bei SQL-Datenbanken ist die physikalische Position des Datensatzes von der jeweiligen Implementierung abhängig. Ist die Tabelle indiziert, wird der Index mit den neuen Datensatzinformationen aktualisiert.

Nachdem der neue Datensatz zurück an den Datenbankserver übermittelt wurde, hängt dessen physikalische Position von der jeweiligen Datenbank ab. Ist die Tabelle indiziert, wird der Index mit den neuen Datensatzinformationen aktualisiert.

Siehe auch

Codebeispiele