- Elemento de navegación
- Consultas de navegación
- Bloqueos
- memorándums
- Contraseña
- Conector Nativo XML
- Varios
HReadFirst (Función)
 No disponible con este tipo de conexión
Posiciones en el primer archivo Record de acuerdo con un artículo de navegación. Se lee el registro y se actualizan las variables HFSQL (por ejemplo, Cliente.Nombre, es decir, el elemento/campo Nombre del archivo de datos Cliente). La lectura se realiza desde el valor más bajo hasta el valor más alto de la posición de exploración (véase observaciones para más detalles). En la mayoría de los casos, HReadFirst se utiliza para establecer la posición en el archivo de datos con el fin de realizar un bucle de lectura con HReadNext. Pueden darse varios casos después de la llamada a HReadFirst: - el archivo de datos está vacía o ningún Record corresponde al filtro (definido por HFilter): no se realiza ninguna lectura y la función HOut devuelve True.
- la función intenta leer un Record que ya está bloqueado en modo de lectura: no se realiza ninguna lectura, HErrorLock devuelve True y HOut devuelve True.
 Acceso con JDBC: La gestión de las cerraduras no está disponible para las bases de datos a las que accede el JDBC.
HReadFirst(Customer, Name)
WHILE HOut(Customer) = False
// Process the record
HReadNext(Customer, Name)
END
Sintaxis
<Result> = HReadFirst([<Data file> [, <Elemento de navegación>] [, <Options>]])
<Result>: Boolean Corresponde a: - False si se produce un error. En este caso, HError devuelve un número entero distinto de 0. HErrorInfo devuelve más detalles sobre el error. El registro no se lee.
- el valor de la función HFound en los demás casos (se puede leer el registro, incluso si <Resultado> devuelve False).
<Data file>: Optional character string (with or without quotes) Nombre del archivo de datos, vista HFSQL o consulta utilizada. Si este parámetro corresponde a una cadena vacía (""), HReadFirst utilizará el último archivo de datos utilizado por la última función de gestión de HFSQL (función que comienza con "H"). <Elemento de navegación>: Optional character string (with or without quotes) Nombre del elemento utilizado para navegar por el archivo de datos o ver (este parámetro es ignorado por las consultas). Si no se especifica este nombre, la función HReadFirst utilizará:- Para un archivo de datos: el último elemento de búsqueda utilizado en este archivo por la última función para la gestión de HFSQL (empezando por la letra H). Si este elemento no existe, se utiliza automáticamente el mejor elemento de navegación.
- For a query: el PEDIDO POR de la consulta si existe, en caso contrario el último ítem utilizado.
- Para una vista: la posición de clasificación de la vista (si existe); de lo contrario, la última posición utilizada.
<Options>: Optional constant Permite configurar:- el bloqueo realizado en el Record leído por HReadFirst
- si se debe tener en cuenta el filtro definido.
| | | hLockNo | Sin bloqueo (incluso si se ha llamado HStartLock): el Record puede ser leído o modificado por otra aplicación durante la lectura.
| | hLockWrite | Bloqueo de escritura: el Record que se lee actualmente puede ser leído por otra aplicación pero no puede ser modificado por otra aplicación.
| | hLockReadWrite | Bloqueo de lectura/escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación.
|  Versiones 17 y posterioreshForwardOnly Nueva funcionalidad versión 17hForwardOnly | | | hKeepFilter | La navegación tendrá en cuenta el filtro establecido con la función HFilter, incluso si la clave de búsqueda no está optimizada para el filtro. Recordatorio: la función HFilter devuelve la clave de búsqueda optimizada para el filtro.
Atención: en este caso, pueden surgir problemas de rendimiento en archivos de datos demasiado grandes.
| | hNoRefresh | |
Observaciones Elemento de navegación Si el elemento de navegación utilizado es una clave, la función HReadFirst lee el registro con el valor de clave más bajo. El orden de clasificación es el que se especificó en el análisis para esta clave. Si se encuentran duplicados, HReadFirst lee el primer registro "duplicado" según el orden de los números de registro. Si el elemento de navegación no es una clave, la función HReadFirst lee el primer registro activo. Al navegar por el archivo, los Record se ordenarán según su número de Record. En este caso, el elemento de navegación seleccionado aparecerá en rojo en el editor de código y aparecerá un aviso en la "Panel"Código. memorándums Los memos asociados con el Record pueden ser leídos automáticamente (o no) cuando se lee el Record. HSetMemo se utiliza para personalizar esta lectura de automatic. Si los memos están soportados, los memos de texto de associated se leen cuando se lee el Record. Los memorándums binarios se leen sólo cuando se usan explícitamente ( HExtractMemo). Contraseña Si la función HReadFirst es la primera función que manipula el archivo de datos especificado, la contraseña se verifica al abrir el archivo de datos. Si la contraseña es incorrecta, HErrorPassword devuelve True y HOut devuelve True. Varios - El número actual de Record es devuelto por HRecNum.
- HChangeKey se utiliza para modificar la clave de búsqueda mientras permanece posicionado en el Record actual.
- Para mejorar los primeros tiempos de navegación en un archivo, usa HOptimize en este archivo de datos.
Esta página también está disponible para…
|
|
|