AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • Lectura o no de la operación según un elemento clave
  • Bloqueos
  • Memos
  • Contraseña
  • 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
Establece la posición en el último registro de un archivo de datos de acuerdo con un elemento de navegación. Se lee el registro y se actualizan las variables HFSQL (por ejemplo, Cliente.Nombre, es decir, el campo Nombre del archivo de datos Cliente).
Se lee el valor más alto de la posición de búsqueda (para más detalles, véase observaciones).
En la mayoría de los casos, <Fuente>.ReadLast se usa para establecer la posición en el archivo de datos para realizar un ciclo de lectura con <Fuente>.ReadPrevious 3000300030002f002300 .
Después de llamar a la función <Fuente>.ReadLast, se pueden producir los siguientes casos:
  • el archivo de datos está vacío o ningún registro corresponde al filtro (definido con la función <Fuente>.Filter): no se realiza ninguna lectura y la función <Fuente>.Out devuelve True.
  • la función intenta bloquear un registro ya bloqueado en modo de lectura: no se realiza ninguna operación de lectura, HErrorLock devuelve True y <Fuente>.Out 02f002300 devuelve True.

Esta función se puede utilizar con archivos de datos, vistas HFSQL o consultas.
Ejemplo
Customer.ReadLast(Name)
WHILE Customer.Out() = False
// Process the record
Customer.ReadPrevious(Name)
END
Sintaxis
<Result> = <Source>.ReadLast([<Browse item> [, <Options>]])
<Result>: Booleano
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 <Fuente>.Found en los demás casos (se puede leer el registro, incluso si <Resultado> devuelve False).
<Source>: Tipo de fuente especificada
Nombre del archivo de datos, vista HFSQL o consulta utilizada.
<Browse item>: Cadena de caracteres opcional
Nombre del elemento utilizado para recorrer el archivo de datos o la vista. Si no se especifica este nombre, la función <Fuente>.ReadLast 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 campo no existe, el mejor campo de navegación se utiliza automáticamente.
  • For a query: el PEDIDO POR de la consulta (si existe), en caso contrario el último ítem utilizado.
  • Para una vista: el elemento de ordenación de la vista (si existe), en caso contrario el último elemento utilizado.
<Options>: Constante o combinación de constantes opcional
Configura:
  • el bloqueo establecido en Record leído por <Fuente>.ReadLast .
  • si se debe tener en cuenta el filtro definido.
hForwardOnly
Conectores Nativos Constante que sólo se puede utilizar con Conectores Nativos (también llamada Accesos Nativos).
Optimiza las iteraciones simples que no utilizan las siguientes características:
  • Leyendo el anterior Record.
  • Modificando un Record.
  • Posición de almacenamiento.
Si se utiliza una de estas características, el resultado puede diferir del esperado.
Por ejemplo, esta constante se puede utilizar cuando se realiza un bucle a través de los registros para rellenar una control Tabla de forma programada.
hKeepFilterEl filtro set de <Fuente>.Filter se tendrá en cuenta, aunque la clave de búsqueda no esté optimizada para el filtro. Recordatorio: la función <Fuente>.Filter devuelve la clave de búsqueda optimizada para el filtro.
Atención: En este caso, pueden surgir problemas de rendimiento para los archivos de datos de gran tamaño.
hLockNoSin bloqeuo: el Record puede ser leído o modificado por otra aplicación durante la lectura.


hLockReadWriteBloqueo de lectura y escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación.



hLockWriteBloqueo de escritura: el registro leído actualmente puede ser leído por otra aplicación, pero no se puede modificar.


hNoRefresh
Conectores Nativos La función <Fuente>.ReadLast no actualiza el contenido de la tabla o consulta. Si es posible, la consulta no se vuelve a ejecutar. Se guardan todas las posiciones guardadas.
Conectores Nativos Las opciones de bloqueo no tendrán efecto si el proveedor OLE DB o el Conector Nativo no soporta los bloqueos.
Conectores Nativos Para Conector Nativo Oracle, se puede especificar un modo de bloqueo diferente para cada Record. Sin embargo, si SQLTransaction inició una transacción antes de establecer el bloqueo, el bloqueo solo se liberará al final de la transacción ( SQLTransaction con la constante sqlCommit o sqlRollBack ).
Observaciones

Lectura o no de la operación según un elemento clave

Si el elemento utilizado es una clave, la función <Fuente>.ReadLast lee el registro con el valor de clave más alto. El criterio de ordenación que se tiene en cuenta es el especificado en el análisis para esta clave. Si se encuentran duplicados, la función <Fuente>.ReadLast lee el último registro "duplicado" según el orden de los números de registro.

Si el elemento no es una clave, la función <Fuente>.ReadLast lee el último registro activo. Al navegar por el archivo de datos, los Record s 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 se mostrará una advertencia en la pantalla de "Panel "Código.
Observación: La autocompletado propone únicamente los puntos clave.
Universal Windows 10 AppiPhone/iPadHFSQL ClassicHFSQL Client/ServerProcedimientos almacenadosConectores Nativos

Bloqueos

De forma predeterminada (parámetro <Options> no especificado), no se bloquean los registros.
Si se solicita un bloqueo (constantes hLockWrite o hLockReadWrite), se leerá el registro solo si este aún no ha sido bloqueado.
Conectores Nativos Las opciones de bloqueo no tendrán efecto si el proveedor OLE DB o el Conector Nativo no soporta los bloqueos.

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).
Universal Windows 10 AppiPhone/iPadHFSQL ClassicHFSQL Client/ServerProcedimientos almacenadosConectores Nativos

Contraseña

Si <Fuente>.ReadLast es la primera función que maneja el archivo de datos especificado, la contraseña se verifica cuando se abre el archivo de datos.. Si la contraseña es incorrecta, la función HErrorPassword devuelve True y la función <Fuente>.Out se establece en True.

Varios

  • La función <Fuente>.RecNum devuelve el número de registro actual.
  • La función <Fuente>.ChangeKey cambia la clave de búsqueda conservando la posición en el registro actual.
  • Para optimizar las primeras iteraciones en un archivo de datos, utilice <Fuente>.Optimize en este archivo de datos.
  • Esta función reemplaza HReadLastLock y HReadLastNoLock , que se mantuvieron por compatibilidad con WINDEV 5.5.
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