Data.DB.TDataSet.AppendRecord

• Übergeordnet: TDataSet

Delphi

procedure AppendRecord(const Values: array of const);

C++

void __fastcall AppendRecord(const System::TVarRec *Values, const int Values_High);

Eigenschaften

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

Beschreibung

Fügt einen neuen Datensatz mit Daten am Ende der Datenmenge hinzu und trägt ihn ein.

Mit AppendRecord können Sie einen neuen leeren Datensatz am Ende der Datenmenge einfügen, ihn mit den in Values übergebenen Feldwerten füllen und in die Datenbank oder das Änderungsprotokoll eintragen.

In C++ ist der Parameter Values ein Array aus Feldwerten. Der Parameter Values_Size ist der Index des letzten Wertes (um eins kleiner als die Gesamtzahl der Werte).

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.

Der neue Datensatz wird anschließend zum aktiven Datensatz.

Siehe auch

• System.TVarRec

• Data.DB.TDataSet.Append
• Data.DB.TDataSet.InsertRecord
• Data.DB.TDataSet.Post
• Data.DB.TDataSet.SetFields
• Komplette Datensätze bearbeiten
• Data.DB.TDataSet.OnNewRecord
• Data.DB.TDataSet.AfterInsert

Codebeispiele

• AppendRecord (Delphi)
• CreateTable (C++)
• RecordCount (C++)
• RecordCount (Delphi)