Data.DB.TDataSet.Insert

Übergeordnet: TDataSet

Delphi

procedure Insert;

C++

HIDESBASE void __fastcall Insert();

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

Fügt einen neuen leeren Datensatz in die Datenmenge ein.

Insert führt folgende Aktionen durch:

1. Ein neuer leerer Datensatz wird in der Datenmenge geöffnet.

2. Der neue wird zum aktiven Datensatz gemacht.

Nach dem Aufruf von Insert können die Benutzer Daten in die Felder des neuen Datensatzes eingeben und anschließend die Änderungen mit Post in die Datenbank oder das Änderungsprotokoll eintragen. (Client-Datenmengen können die zwischengespeicherten Änderungen danach durch einen Aufruf von ApplyUpdates in die Datenquelle eintragen.) Ein neu eingefügter Datensatz wird auf eine von drei Arten in die Datenbank eingetragen:

Bei Paradox-Tabellen mit Primärindex wird der Datensatz anhand seiner Indexposition in die Datenmenge eingefügt.

Bei Paradox-Tabellen ohne Primärindex wird der Datensatz an der aktuellen Position in die Datenmenge eingefügt.

Bei dBASE-, FoxPro- und Access-Tabellen wird der Datensatz physikalisch am Ende der Datenmenge hinzugefügt. Wenn ein Index aktiv ist, kann der Datensatz anhand seiner Indexposition angezeigt werden, er ist aber tatsächlich am Ende der Tabelle gespeichert.

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.