CURSORGETPROP( ) (Función)
Devuelve la configuración actual de propiedad de una tabla o un cursor de Visual FoxPro.
CURSORGETPROP(cProperty [, nWorkArea | cTableAlias])
Valores devueltos
Character, Numeric o Logical
Parámetros
cProperty
Especifica la propiedad cuya configuración se va a devolver.La tabla siguiente incluye una lista de propiedades cuya configuración puede devolverse, el tipo de datos del valor que devuelve y una descripción del valor que devuelve.
cProperty Tipo Descripción BatchUpdateCount* N El número de instrucciones de actualización enviadas al origen de datos para tablas almacenadas en búfer. 1 es el valor predeterminado. Ajustar este valor puede aumentar considerablemente el rendimiento. Lectura y escritura.
Almacenamiento en búfer N 1 – (Valor predeterminado) El almacenamiento de filas y tablas en búfer está desactivado. 2 – El almacenamiento pesimista de filas en búfer está activado.
3 – El almacenamiento optimista de filas en búfer está activado.
4 – El almacenamiento pesimista de tablas en búfer está activado.
5 – El almacenamiento optimista de tablas en búfer está activado.
Lectura y escritura.
CompareMemo L Contiene verdadero (.T.) (valor predeterminado) si los campos memo (del tipo Memo, General, o Picture) están incluidos en la cláusula WHERE para actualizaciones; de lo contrario, contiene falso (.F.). Sólo para vistas. Lectura y escritura.
ConnectHandle N El controlador de conexión. Esta propiedad sólo será válida cuando el origen de datos contenga una tabla remota. Sólo lectura.
ConnectName C La conexión con nombre empleada cuando se crea el cursor. Esta propiedad sólo será válida cuando el origen de datos contenga una tabla remota. Sólo lectura.
Base de datos C El nombre de la base de datos donde se encuentra la tabla o la vista. Si se trata de una tabla libre, contiene la cadena vacía. Sólo lectura.
FetchAsNeeded L Contiene verdadero (.T.) si los datos se buscan cuando sea necesario; de lo contrario, contiene falso (.F.) (valor predeterminado). Sólo para vistas. Lectura y escritura.
FetchMemo* L Contiene verdadero (.T.) si se toman los campos memo con los resultados de la vista; de lo contrario, contiene falso (.F.) (valor predeterminado). Lectura y escritura.
FetchSize* N El número de filas tomadas progresivamente del conjunto de resultados de la tabla remota. 100 filas es el valor predeterminado. Si se ajusta FetchSize como -1, se recupera el conjunto completo de resultados (limitado por el valor de MaxRecords). Lectura y escritura.
KeyFieldList C Lista delimitada por comas de los campos principales para el cursor. Lectura y escritura.
MaxRecords* N El número máximo de filas tomadas cuando se devuelven los conjuntos de resultados. El valor predeterminado es – 1 (se devuelven todas las filas). Un valor de 0 especifica que se ejecuta la vista pero que no se toman resultados. Lectura y escritura.
Prepared L Contiene verdadero (.T.) si las instrucciones SQL están preparadas para llamadas a funciones REQUERY( ) subsiguientes; de lo contrario, contiene falso (.F.) (valor predeterminado). REQUERY( ) sirve para recuperar los datos para una vista SQL. Vea SQLPREPARE( ) para obtener información adicional acerca de la preparación de instrucciones SQL. Sólo para vistas. Lectura y escritura.
SendUpdates L Contiene verdadero (.T.) si se envía una consulta de actualización SQL para actualizar tablas remotas; de lo contrario, contiene falso (.F.) (el valor predeterminado). Lectura y escritura.
SourceName C Contiene el nombre largo para una vista o tabla SQL de una base de datos, o la ruta de acceso del archivo y el nombre de tabla para una tabla libre. Sólo lectura.
SourceType N 1 – Especifica que el origen de datos es una vista SQL local. 2 – Especifica que el origen de datos es una vista SQL remota.
3 – Especifica que el origen de datos es una tabla.
Sólo lectura.
SQL C La instrucción SQL ejecutada cuando se crea el cursor. Sólo lectura.
Tablas C Lista delimitada por comas de los nombres de las tablas remotas. Lectura y escritura.
UpdatableFieldList C Lista delimitada por comas de campos en la vista. Esta lista puede incluir campos de tablas locales y remotas. Lectura y escritura.
UpdateNameList C Lista delimitada por comas de nombres de campos remotos y los nombres de campos locales asignados al cursor. Utilice esta opción para especificar nombres válidos de Visual FoxPro para campos del cursor que tengan nombres no válidos para Visual FoxPro. Lectura y escritura.
UpdateType N 1 – Especifica que los datos antiguos se actualizan con los datos nuevos (predeterminado). 2 – Especifica que para actualizar los datos, se eliminan los datos antiguos y se insertan los nuevos.
Lectura y escritura.
UseMemoSize* N El tamaño mínimo (en bytes) para el que se devuelven columnas de resultado en campos memo. Por ejemplo, si el ancho de un resultado de columna es mayor que el valor de UseMemoSize, dicho resultado se almacena en un campo memo. UseMemoSize puede variar de 1 a 255; el valor predeterminado es 255. Lectura y escritura.
WhereType N La cláusula WHERE empleada para actualizar tablas. WhereType puede asumir los valores siguientes: 1 o DB_KEY (de FOXPRO.H). La cláusula WHERE usada para actualizar tablas remotas sólo consta de campos principales especificados con la propiedad KeyFieldList.
2 o DB_KEYANDUPDATABLE (de FOXPRO.H). La cláusula WHERE usada para actualizar tablas remotas consta de los campos principales especificados con la propiedad KeyFieldList y cualquier campo actualizable.
3 o DB_KEYANDMODIFIED (de FOXPRO.H) (valor predeterminado). La cláusula WHERE empleada para actualizar tablas remotas consta de los campos principales especificados con la propiedad KeyFieldList y cualquier otro campo modificado.
4 o DB_KEYANDTIMESTAMP (de FOXPRO.H). La cláusula WHERE usada para actualizar tablas remotas consta de los campos principales especificados con la propiedad KeyFieldList y una comparación de las marcas de hora.
Lectura y escritura.
* El valor devuelto por esta propiedad sólo es significativo para vistas remotas; si obtiene esta propiedad para vistas locales, la función CURSORGETPROP devolverá el valor predeterminado.
La tabla siguiente incluye una lista de propiedades cuya configuración puede devolverse, el tipo de datos del valor que devuelve y una descripción del valor que devuelve.
nWorkArea
Especifica el área de trabajo de la tabla o el cursor desde el que se devuelve la configuración de la propiedad. Si especifica 0 para nWorkArea, CURSORGETPROP( ) devuelve el valor de entorno.cTableAlias
Especifica el alias de la tabla o el cursor desde los que se devuelve la configuración de la propiedad.
Observaciones
Utilice CURSORSETPROP( ) para establecer una propiedad específica para una tabla o un cursor de Visual FoxPro. Vea CURSORSETPROP( ) para obtener información adicional acerca de cada una de las propiedades y sus configuraciones.
La configuración actual de la propiedad se devuelve para la tabla o el cursor abierto en el área de trabajo seleccionada actualmente si se ejecuta CURSORGETPROP( ) sin los argumentos opcionales cTableAlias o nWorkArea.
Ejemplo
El ejemplo siguiente abre la tabla customer de la base de datos testdata. Se usa CURSORGETPROP( ) para mostrar el modo de almacenamiento en búfer para la tabla y el nombre de la base de datos donde está contenida la tabla.
CLOSE DATABASES
CLEAR
OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer && Open customer table
? CURSORGETPROP("Buffering") && Displays buffering mode
? CURSORGETPROP("Database") && Displays database name