CURSORGETPROP( )-Funktion
Gibt die aktuellen Einstellungen der Eigenschaften einer Visual FoxPro-Tabelle oder eines Cursors zurück.
CURSORGETPROP(cProperty [, nWorkArea | cTableAlias])
Rückgabewerte
Zeichen, Numerisch oder Logisch
Parameter
cProperty
Gibt die Eigenschaft an, deren Einstellung zurückgegeben wird.Die folgende Tabelle enthält eine Liste der Eigenschaften, deren Einstellungen ermittelt werden können, den jeweiligen Datentyp und eine Beschreibung des Rückgabewertes.
cProperty Typ Beschreibung BatchUpdateCount* N Bei gepufferten Tabellen die Anzahl der Aktualisierungsanweisungen, die an die Remotedatenquelle geschickt werden. Die Standardeinstellung ist 1. Durch die Anpassung dieses Wertes kann die Aktualisierungsleistung erheblich verbessert werden. Lese-/Schreibzugriff.
Buffering N 1 – (Standardeinstellung) Zeilen- und Tabellenpufferung sind deaktiviert. 2 – Pessimistische Zeilenpufferung ist aktiviert.
3 – Optimistische Zeilenpufferung ist aktiviert.
4 – Pessimistische Tabellenpufferung ist aktiviert.
5 – Optimistische Tabellenpufferung ist aktiviert.
Lese-/Schreibzugriff.
CompareMemo L Enthält den Standardwert Wahr (.T.), wenn in der WHERE-Klausel für Aktualisierungen Memofelder (Typ Memo, Objekt oder Bild) berücksichtigt werden, andernfalls ist der Wert Falsch (.F.). Nur für Sichten. Lese-/Schreibzugriff.
ConnectHandle N Das Handle der Verbindung. Diese Eigenschaft ist nur dann gültig, wenn die Datenquelle eine Remotetabelle enthält. Schreibgeschützt.
ConnectName C Die bei Erstellen des Cursors verwendete benannte Verbindung. Diese Eigenschaft ist nur dann gültig, wenn die Datenquelle eine Remotetabelle enthält. Schreibgeschützt.
Database C Der Name der Datenbank, welche die Tabelle oder Sicht enthält. Handelt es sich um eine freie Tabelle, so enthält diese Eigenschaft die leere Zeichenfolge. Schreibgeschützt.
FetchAsNeeded L Enthält Wahr (.T.), wenn Daten nur bei Bedarf abgerufen werden, andernfalls enthält diese Eigenschaft den Standardwert Falsch (.F.). Nur für Sichten. Lese-/Schreibzugriff.
FetchMemo* L Enthält Wahr (.T.), wenn Memofelder mit den Ergebnissen der Ansicht abgerufen werden, andernfalls enthält diese Eigenschaft den Standardwert Falsch (.F.). Lese-/Schreibzugriff.
FetchSize* N Die Anzahl der Zeilen, die kontinuierlich aus dem Resultset der Tabelle abgerufen werden. Die Standardeinstellung ist 100 Zeilen. Das gesamte Resultset (soweit entsprechend der MaxRecords-Einstellung zulässig) wird abgerufen, wenn FetchSize auf -1 gesetzt ist. Lese-/Schreibzugriff.
KeyFieldList C Durch Kommas getrennte Liste der Schlüsselfelder für den Cursor. Lese-/Schreibzugriff.
MaxRecords* N Die maximale Anzahl an Zeilen, die bei Rückgabe von Resultsets abgerufen werden. Der Standardwert ist -1 (alle Zeilen werden zurückgegeben). Mit dem Wert 0 wird angegeben, dass die Sicht (Ansicht) zwar ausgeführt wird, aber keine Ergebnisse abgerufen werden. Lese-/Schreibzugriff.
Prepared L Enthält Wahr (.T.), wenn SQL-Anweisungen für folgende Aufrufe der REQUERY( )-Funktion vorbereitet werden, andernfalls enthält Prepared den Standardwert Falsch (.F.). Mit REQUERY( ) können die Daten einer SQL-Sicht erneut abgerufen werden. Weitere Informationen zum Vorbereiten von SQL-Anweisungen finden Sie unter SQLPREPARE( ). Nur für Sichten. Lese-/Schreibzugriff.
SendUpdates L Enthält Wahr (.T.), wenn bei einer Aktualisierung durch die Sicht eine SQL-Aktualisierungsabfrage zum Aktualisieren der Tabellen gesendet wird; andernfalls enthält diese Eigenschaft den Standardwert Falsch (.F.). Lese-/Schreibzugriff.
SourceName C Enthält den langen Namen einer SQL-Sicht oder einer Tabelle in einer Datenbank bzw. bei einer freien Tabelle die Pfadangabe und den Tabellennamen. Schreibgeschützt.
SourceType N 1 – Gibt an, dass es sich bei der Datenquelle oder eine lokale SQL-Sicht handelt. 2 – Gibt an, dass es sich bei der Datenquelle um eine Remote-SQL-Sicht handelt.
3 – Gibt an, dass es sich bei der Datenquelle um eine Tabelle handelt.
Schreibgeschützt.
SQL C Die bei Erstellen des Cursors ausgeführte SQL-Anweisung. Schreibgeschützt.
Tables C Durch Kommas getrennte Liste der Tabellennamen. Lese-/Schreibzugriff.
UpdatableFieldList C Durch Kommas getrennte Liste der Felder der Sicht (Ansicht). Diese Liste kann Felder aus lokalen und aus Remotetabellen enthalten. Lese-/Schreibzugriff.
UpdateNameList C Durch Kommas getrennte Liste der Feldnamen und der dem Cursor zugewiesenen lokalen Feldnamen. Mit dieser Option können Sie gültige Visual FoxPro-Namen für Felder im Cursor angeben, die ungültige Visual FoxPro-Feldnamen tragen. Lese-/Schreibzugriff.
UpdateType N 1 – Gibt an, dass bisherige Daten mit den neuen Daten aktualisiert werden (Standardeinstellung). 2 – Gibt an, dass bei Aktualisierungen die alten Daten gelöscht und die neuen eingefügt werden.
Lese-/Schreibzugriff.
UseMemoSize* N Die Mindestgröße (in Bytes), bei der Ergebnisspalten in Memofeldern zurückgegeben werden. Ist die Breite einer Ergebnisspalte größer als der Wert von UseMemoSize, so wird die Ergebnisspalte in ein Memofeld geschrieben. Der Wert von UseMemoSize kann zwischen 1 und 255 liegen, der Standardwert ist 255. Lese-/Schreibzugriff.
WhereType N Die WHERE-Klausel für Aktualisierungen in Tabellen. WhereType kann einen der folgenden Werte haben: 1 oder DB_KEY (aus FOXPRO.H). Die WHERE-Klausel zum Aktualisieren von Tabellen besteht nur aus den mit der KeyFieldList-Eigenschaft angegebenen Schlüsselfeldern.
2 oder DB_KEYANDUPDATABLE (aus FOXPRO.H). Die WHERE-Klausel zum Aktualisieren von Tabellen besteht aus den mit der KeyFieldList-Eigenschaft angegebenen Schlüsselfeldern und allen aktualisierbaren Feldern.
3 oder DB_KEYANDMODIFIED (aus FOXPRO.H) (Standard). Die WHERE-Klausel zum Aktualisieren von Tabellen besteht aus den mit der KeyFieldList-Eigenschaft angegebenen Schlüsselfeldern und allen anderen Feldern, die aktualisiert werden.
4 oder DB_KEYANDTIMESTAMP (aus FOXPRO.H). Die WHERE-Klausel zum Aktualisieren von Tabellen besteht aus den mit der KeyFieldList-Eigenschaft angegebenen Schlüsselfeldern und einem Vergleich der Zeitstempelfelder.
Lesen/Schreiben.
* Der von dieser Eigenschaft zurückgegebene Wert ist nur für Remotesichten von Bedeutung; wenn Sie den Wert dieser Eigenschaft für lokale Sichten ermitteln, gibt die CURSORGETPROP-Funktion den Standardwert zurück.
Die folgende Tabelle enthält eine Liste der Eigenschaften, deren Einstellungen ermittelt werden können, den jeweiligen Datentyp und eine Beschreibung des Rückgabewertes.
nWorkArea
Gibt den Arbeitsbereich der Tabelle oder des Cursors an, dessen Eigenschafteneinstellung zurückgegeben wird. Wenn Sie für nWorkArea 0 angeben, gibt CURSORGETPROP( ) die Umgebungseinstellung zurück.cTableAlias
Gibt den Alias der Tabelle oder des Cursors an, dessen Eigenschafteneinstellung zurückgegeben wird.
Hinweise
Mittels CURSORSETPROP( ) können Sie eine bestimmte Eigenschaft einer Visual FoxPro-Tabelle oder eines Cursors setzen. Weitere Informationen zu den Eigenschaften und deren Einstellungen finden Sie unter CURSORSETPROP( ).
Wenn CURSORGETPROP( ) ohne die optionalen Argumente cTableAlias oder nWorkArea eingegeben wird, werden die aktuellen Eigenschafteneinstellungen für die Tabelle oder den Cursor zurückgegeben, der im aktuellen Arbeitsbereich geöffnet ist.
Beispiel
Im folgenden Beispiel wird die Tabelle customer in der Datenbank testdata geöffnet. Mittels CURSORGETPROP( ) wird dann der Zwischenspeicherungsmodus (Pufferungsmodus) der Tabelle sowie der Name der Datenbank, die die Tabelle enthält, angezeigt.
CLOSE DATABASES
CLEAR
OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer && Open customer table
? CURSORGETPROP("Buffering") && Displays buffering mode
? CURSORGETPROP("Database") && Displays database name