DBInsert()
DBInsert() – Datensatz einfügen
Die Funktion fügt einen neuen Datensatz an eine Tabelle an. Nach dem Aufruf von DBInsert() können Werte für die Datenfelder des neuen Datensatzes zugewiesen werden. Um den neuen Datensatz zu speichern, muss die Funktion DBPost() aufgerufen werden.
Hinweis
Die Funktion sollte ab Version 6.1 nicht mehr verwendet werden. Dafür stehen nun direkte Funktionen der Tabellen (TBeStandardTable, TBeRightsTable, TBeAdsQuery oder TBeMemTable) zur Verfügung.
oTable.CbInsert()
DBInsert() löst keine Exception aus, falls der Vorgang nicht möglich war und UseDbExceptions nicht gesetzt ist (default).
oTable.CbInsert() löst hingegen immer eine Exception aus, wenn der Vorgang nicht möglich war.
Parameter | Beschreibung |
---|---|
aTable:U | Bezugstabelle; default = Standard-Tabelle |
Rückgabewert
Logisch / Boolean - Einfügen erfolgreich
Beispiel
| oDab000:DB := 'waDAB000', aKdNr |
DBGoBottom(oDab000),
WriteLn(oDab000:KDNR),
WriteLn(oDab000:NAME1),
aKdNr := oDab000:KDNR + 1,
DBInsert(oDab000),
oDab000:KDNR := aKdNr,
oDab000:NAME1 := "Neue Firma (TEST!)",
DBPost(oDab000),
DBGoBottom(oDab000),
WriteLn(oDab000:KDNR),
WriteLn(oDab000:NAME1),