OdbcRecordOpenEx

value OdbcRecordOpenEx ( value dxDatabase, value BYREF dxRecord, string strSQL, string/value BYREF varToBind... );

Rückgabewert

Rückgabewert

Beschreibung

0

Die Datensatzobjekt dxRecord wurde erfolgreich erstellt.

-1

Die Datensatzobjekt dxRecord konnte nicht erstellt werden.

Null wenn das Datensatzobjekt dxRecord erfolgreich erstellt wurde, -1 wenn das Datenbankobjekt ungültig ist.

Parameter

dxDatabase

Das Datenbankobjekt, das die Datensätze zur Verfügung stellen soll.

dxRecord

Konnte das Datensatzobjekt  erfolgreich angelegt werden, so wird dxRecord mit einem Verweis auf dieses Datensatzobjekt geladen. Nachfolgenden OdbcRecord-Funktionsaufrufen muss dieses Datensatzobjekt übergeben werden.

strSQL

Eine SQL-Anweisung, die angibt, welche Datensätze des Datensatzobjekts gebunden werden sollen.

Der String kann enthalten: Den Namen einer Tabelle oder eine SELECT-Anweisung (optional mit einer WHERE und/oder ORDER BY-Anweisung).

varToBind

Gibt die Variablen an, denen die an  Ergebnis der Abfrage der ersten Zeile zugewiesen werden soll. Es sollten genau so viele Variablen varToBind übergeben werden, wie die SQL-Select Anweisung im Ergebnis besitzen kann.

Bemerkungen

Öffnet ein Datensatzobjekt entsprechende der SQL-Anweisung strSQL und alle Variablen varToBind in der Reihenfolge der Übergabe mit den Ergebnisfeldern der SQL-Anweisung. Das geöffnete Datensatzobjekt wird dxRecord zugewiesen.
Das Datensatzobjekt wird im ODBC_OpenSnapshot Modus geöffnet.

Der erzeugte Verweis auf das Datensatzobjekt dxRecord muss, wenn er nicht mehr verwendet wird, mit OdbcRecordClose geschlossen werden. Beim Stoppen/Beenden der Visualisierung werden alle gültigen und nicht geschlossen Datensatzobjekte automatisch geschlossen.

Verweist dxRecord beim Aufruf auf ein gültiges Datensatzobjekt (das also vorher mit OdbcRecordOpenEx bzw. OdbcRecordOpen erzeugt und nicht mit OdbcRecordClose geschlossen wurde) so wird dieses alte Datensatzobjekt automatisch geschlossen, bevor das neue Datensatzobjekt erzeugt wird.

OdbcRecordOpenEx ist die verkürzte From der Öffnensequence bestehende aus einem OdbcRecordOpen, mindestens einem OdbcRecordBindField und einem OdbcRecordBindCompleted Aufruf.

Beispiel

Im nachfolgenden Beispiel werden einige Felder mit Variablen gebunden.

OdbcRecordOpenEx(dxDatabase, dxRecord, "select Name, Street, ZIP, City from Customers", customerName, customerStreet, customerZIP, customerCity);

Zum Vergleich die klassische Variante

OdbcRecordOpen(dxDatabase, dxRecord, "select Name, Street, ZIP, City from Customers");
OdbcRecordBindField(dxRecord, "Name", customerName);
OdbcRecordBindField(dxRecord, "Street", customerStreet);
OdbcRecordBindField(dxRecord, "ZIP", customerZIP);
OdbcRecordBindField(dxRecord, "City", customerCity);
OdbcRecordBindCompleted(dxRecord);

Die ODBC Datenbankfunktionen

Siehe auch OdbcRecordAddNew, OdbcRecordCanAppend, OdbcRecordCanBookmark, OdbcRecordCanRestart, OdbcRecordCanScroll, OdbcRecordCanTransact, OdbcRecordCancelUpdate, OdbcRecordClose, OdbcRecordDelete, OdbcRecordEdit, OdbcRecordGetRecordCount, OdbcRecordIsBOF, OdbcRecordIsDeleted, OdbcRecordIsEOF, OdbcRecordIsOpen, OdbcRecordMove, OdbcRecordMoveFirst, OdbcRecordMoveLast, OdbcRecordMoveNext, OdbcRecordMovePrev, OdbcRecordRequery, OdbcRecordSetAbsolutePosition, OdbcRecordUpdate