|
|
|
|
- Los registros leen
- En bucle a través de un archivo de datos
- Memos
- Bloqueos
- Varios
<Fuente>.Read (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. <Fuente>.State se utiliza para conocer el estado de record (active, cruzado o borrado). En general, la función <Fuente>.Read permite posicionarse en el archivo de datos para realizar un bucle de lectura indicando el número de registro. Tras la llamada a <Fuente>.Readpueden 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 <Fuente>.Out devuelve True.
- el número especificado de Record ya no existe (cruzado Record, borrado Record, ...): no se realiza ninguna lectura y la función <Fuente>.Out devuelve False.
Utilice <Fuente>.State para conocer el estado de Record. - el archivo de datos está vacía: <Fuente>.Out devuelve True.
- la función intenta bloquear un registro ya bloqueado en modo de lectura: HErrorLock devuelve True y <Fuente>.Out 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.
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_ Customer.NbRec(hStateAll) Customer.Read(i) IF Customer.State() = hStateActive THEN Info("Customer name: " + Customer.Name) END END
Sintaxis
<Result> = <Source>.Read([<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.
<Source>: Tipo de fuente especificada Nombre del archivo de datos HFSQL, vista o consulta utilizada. <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), <Fuente>.Read leerá el Record actual.
<Options>: Constante opcional Configura el bloqueo establecido en el Record leído por <Fuente>.Read: | | 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. <Fuente>.SetMemo 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 ( <Fuente>.ExtractMemo).
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|