SQLCOLUMNS( )-Funktion
Speichert eine Liste mit Spaltennamen und Informationen zu jeder Spalte für die als Datenquelle angegebene Tabelle in einem Visual FoxPro-Cursor.
SQLCOLUMNS(nConnectionHandle, TableName
[, "FOXPRO" | "NATIVE"] [, CursorName])
Rückgabewerte
Numerisch
Parameter
nConnectionHandle
Gibt das aktive Verbindungshandle an.TableName
Gibt den Namen der Tabelle an, aus der die Spaltennamen zurückgegeben werden. TableName kann die Platzhalter Fragezeichen (?) und Sternchen (*) enthalten. Das Fragezeichen (?) steht für ein einzelnes Zeichen, während das Sternchen (*) für eine beliebige Anzahl von Zeichen steht.FOXPRO | NATIVE
Gibt das Format für die Spalteninformationen im Resultset an. Achten Sie bitte darauf, FOXPRO oder NATIVE in Anführungszeichen zu setzen. Die NATIVE-Formatoption speichert Spalteninformationen für Tabellen im Format der Datenquelle. Die FOXPRO-Formatoption speichert die Spalteninformationen in dem Format, das für die Visual FoxPro-Tabelle oder für den Visual FoxPro-Cursor erstellt würde, falls Sie die Datenquellentabelle nach Visual FoxPro importieren würden. Wenn Sie weder FOXPRO noch NATIVE angeben, wird die Standardeinstellung der Formatoption (FOXPRO) verwendet.Die folgende Tabelle zeigt die Spalten im Resultset im FOXPRO-Format.
Spaltenname Beschreibung Field_name Spaltenname Field_type Datentyp der Spalte Field_len Spaltenlänge Field_dec Anzahl der Dezimalstellen Die folgende Tabelle zeigt die Spalten im Resultset im NATIVE-Format. Möglicherweise werden im NATIVE-Format weitere Spalten im Resultset angezeigt, die nicht in der folgenden Tabelle aufgeführt sind. Das Auftreten solcher Spalten hängt von der Datenquelle ab.
Spaltenname Beschreibung Table_qualifier Kennung Tabellenkennzeichnung Table_owner Kennung Tabelleneigentümer Table_name Tabellenkennung Column_name Spaltenkennung Data_type Datentyp der Spalte Type_name Name des Datentyps der Spalte Precision Genauigkeit der Spalte Length Übertragungsgröße der Daten Scale Skalierung der Spalte Radix Basis für Typ Numerisch Nullable NULL-Wertunterstützung Hinweise Beschreibung der Spalte Wenn die mit TableName angegebene Tabelle nicht vorhanden ist und das Format auf NATIVE gesetzt ist, gibt SQLCOLUMNS( ) den Wert Wahr (.T.) zurück und erstellt eine leere Tabelle oder einen leeren Cursor. Wenn die mit TableName angegebene Tabelle nicht vorhanden ist und das Format auf FOXPRO gesetzt ist, gibt SQLCOLUMNS( ) den Wert Falsch (.F.) zurück.
CursorName
Gibt den Namen des Visual FoxPro-Cursors für das Resultset an. Wenn Sie keinen Cursornamen angeben, verwendet Visual FoxPro den Standardnamen SQLRESULT.
Hinweise
SQLCOLUMNS( ) gibt folgende Werte zurück: 1, wenn der Cursor erfolgreich erstellt wurde; 0, wenn SQLCOLUMNS( ) noch aktiv ist; -1 bei einem Fehler auf Verbindungsebene und -2 bei einem Fehler auf Umgebungsebene.
SQLCOLUMNS( ) gehört zu den vier Funktionen, die Sie entweder synchron oder asynchron ausführen können. Die Asynchronous-Einstellung von SQLSETPROP( ) legt fest, ob diese Funktionen synchron oder asynchron ausgeführt werden. Im Asynchronmodus müssen Sie SQLCOLUMNS( ) wiederholt aufrufen, bis ein anderer Wert als Falsch (.F.) (wird noch ausgeführt) zurückgegeben wird.
Beispiel
Im folgenden Beispiel wird davon ausgegangen, dass SQLCONNECT( ) erfolgreich ausgeführt und der entsprechende Rückgabewert in der Speichervariablen gnConnHandle gespeichert wird. Mit SQLCOLUMNS( ) wird der Cursor MyCursor erstellt. Dieser Cursor enthält Informationen über die Spalten der Tabelle authors.
= SQLCOLUMNS(gnConnHandle, 'authors', 'FOXPRO', 'MyCursor')