AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • Los registros leen
  • En bucle a través de un archivo de datos
  • Memos
  • Bloqueos
  • Varios
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
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.
    Java 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.
Ejemplo
// 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.
OLE DBConectores Nativos <Fuente>.Read lee sólo el record actual. No se puede especificar un número de Record que no sea el actual. Para especificar el registro actual, utilice la constante hCurrentRecNum.
Java Acceso con JDBC: <Fuente>.Read lee sólo el record actual. No se puede especificar un número de Record que no sea el actual. Para especificar el registro actual, utilice la constante hCurrentRecNum.
<Options>: Constante opcional
Configura el bloqueo establecido en el Record leído por <Fuente>.Read:
hLockNoSin bloqeuo: la Record puede ser leída o modificada por otra aplicación durante la lectura.
hLockReadWriteBloqueo de lectura/escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación.
hLockWriteBloqueo 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.
Hyper File 5.5 Las opciones de bloqueo se ignoran. Utilizar las funciones de bloqueo (<Fuente>.LockRecNum) conservadas para la compatibilidad con el pasado.
OLE DBConectores Nativos Las opciones de bloqueo no tendrán efecto si los bloqueos no son soportados por el proveedor OLE DB o por Conector Nativo.
Java Acceso con JDBC: Este parámetro no se tiene en cuenta.
Observaciones
WINDEVUniversal Windows 10 AppJavaCódigo de Usuario (UMC)Lenguaje ExternoHFSQL ClassicHFSQL Client/ServerProcedimientos almacenadosHyper File 5.5

Los registros leen

La función <Fuente>.Read es la única función que permite acceder a un registro tachado o eliminado. Si se borra el Record, el contenido del Record ya no es válido.

En bucle a través de un archivo de datos

<Fuente>.Read no puede utilizarse para continuar una iteración iniciada por <Fuente>.ReadFirst, <Fuente>.ReadNext.

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).
WINDEVUniversal Windows 10 AppCódigo de Usuario (UMC)Lenguaje ExternoHFSQL ClassicHFSQL Client/ServerProcedimientos almacenadosHyper File 5.5OLE DBConectores Nativos

Bloqueos

Por defecto (<Opciones> no especificadas), la Record no está bloqueada.
Si se solicita un bloqueo (constantes hLockWrite o hLockReadWrite), se leerá el registro solo si este aún no ha sido bloqueado.
OLE DBConectores Nativos Las opciones de bloqueo no tendrán efecto si los bloqueos no son soportados por el proveedor OLE DB o por Conector Nativo.

Varios

Componente: wd290hf.dll
Versión mínima requerida
  • Versión 25
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 20/06/2023

Señalar un error o enviar una sugerencia | Ayuda local