|
|
|
|
- Los registros leen
- En bucle a través de un archivo de datos
- Memos
- Bloqueos
- Varios
HRead (Función)
No disponible con este tipo de conexión
Lee un Record en un archivo de datos según un número Record dado. Este modo de lectura se llama "Acceso directo".. La lectura de Record está cargada en la memoria. HState se utiliza para conocer el estado de record (active, cruzado o borrado). En general, la función HRead permite posicionarse en el archivo de datos para realizar un bucle de lectura indicando el número de registro. Tras la llamada a HReadpueden darse varios casos: - el número de Record especificado no existe (mayor que el número total de Record s o negativo): no se realiza ninguna lectura y la función HOut devuelve True.
- el número especificado de Record ya no existe (cruzado Record, borrado Record, ...): no se realiza ninguna lectura y la función HOut devuelve False.
Utilice HState para conocer el estado de Record. - el archivo de datos está vacía: HOut devuelve True.
- la función intenta bloquear un registro ya bloqueado en modo de lectura: HErrorLock devuelve True y HOut devuelve True.
Esta función se puede utilizar con los archivos de datos (indexados o no) y con las vistas HFSQL.
// Sequential iteration to display the name of all customers i is int FOR i = 1 _TO_ HNbRec(Customer, hStateAll) HRead(Customer, i) IF HState() = hStateActive THEN Info("Customer name: " + Customer.Name) END END
Sintaxis
<Result> = HRead([<Data file> [, <Record number> [, <Options>]]])
<Result>: booleano - True si se leyó el registro,
- False si se produce un error (bloqueo, fin del archivo de datos, etc.): el registro no se lee. La función HError permite identificar el error.
<Data file>: Cadena de caracteres opcional Nombre del archivo de datos HFSQL, vista o consulta utilizada.Si este parámetro es una cadena vacía (""), HRead manipula el último archivo de datos utilizado por la última función HFSQL (función que empieza por "H"). <Record number>: Entero opcional Número de la Record para leer.Si no se especifica este parámetro (o es igual a 0 o a la constante hCurrentRecNum), HRead leerá el Record actual.
<Options>: Constante opcional Configura el bloqueo establecido en el Record leído por HRead: | | hLockNo | Sin bloqeuo: la Record puede ser leída o modificada por otra aplicación durante la lectura. | hLockReadWrite | Bloqueo de lectura/escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación. | 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. |
Observaciones En bucle a través de un archivo de datos Memos 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 operación de lectura de automatic. Si los memos están soportados, los memos de texto asociados se leen cuando se lee la Record. Los memos binarios sólo se leen cuando se utilizan explícitamente ( HExtractMemo). Varios - El resultado de HFound debe ignorarse (HFound debe utilizarse para las búsquedas realizadas por HReadSeekFirst y HReadSeekLast).
- El número actual de Record es devuelto por HRecNum. El primer Record que se encontró en el archivo de datos es Record #1.
- Esta función sustituye a HReadLock y HReadNoLock, que se mantuvieron por compatibilidad con WINDEV 5.5.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|