AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Administrar bases de datos / HFSQL / Funciones HFSQL
  • Lectura o no de la operación según un elemento clave
  • Memos
  • Varios
  • Cierre
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
Retrocede varios registros en el archivo de datos a partir de la posición actual, según un elemento especificado.
El registro de destino se lee y se carga en la memoria: se actualizan las variables HFSQL (Customer.Name por ejemplo, que significa el elemento Name del archivo Customer).
Tras la llamada a HBackwardpueden darse varios casos:
  • no existen más registros en el archivo de datos: HOut devuelve True. No se realiza ninguna lectura.
  • la función intenta bloquear un registro ya bloqueado en modo de lectura: HErrorLock devuelve True y HOut devuelve True.
    PHP La gestión de las cerraduras no está disponible en PHP.
    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 archivos de datos, vistas HFSQL o consultas.
Ejemplo
// Go back to the 200th record of the Customer data file
// according to the CustName key
HReadLast(Customer, CustName)
HBackward(Customer, CustName, 199)
Sintaxis
<Result> = HBackward([<Data file> [, <Item>] [, <Step> [, <Options>]]])
<Result>: booleano
  • True si se retrocedió en el archivo de datos,
  • 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, vista o consulta utilizada. Si no se especifica este nombre, la función HBackward utilizará el último archivo de datos utilizado por la última función HFSQL (que empieza por "H").
<Item>: Cadena de caracteres opcional
Nombre del artículo según el cual se realiza la búsqueda. Si no se especifica este nombre, HBackward se encarga del último elemento de el archivo de datos utilizado por la última función HFSQL (función que empieza por "H").
OLE DBConectores Nativos Todos los elementos utilizados para retroceder en el archivo se consideran elementos clave.
PHP El parámetro <Step> es obligatorio si no se especifica este parámetro.
<Step>: Entero opcional
Número de pasos hacia atrás (lo que significa número de registros a examinar). Por defecto, <Intervalo> = 1.
<Options>: Constante o combinación de constantes de tipo Integer (opcional)
Configura:
  • el modo de bloqueo aplicado a la Record leyó. Por Default, el bloqueo realizado corresponde al bloqueo actual.
    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.

    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.
  • la gestión de los duplicados durante la navegación. Por Default, todos los duplicados son examinados.
    hDistinctCuando se realiza una búsqueda en un elemento clave, se busca un solo Record si se encuentran duplicados.
Hyper File 5.5 <Las opciones> se ignoran.
PHP <Las opciones> se ignoran.
Java Acceso con JDBC: <Las opciones> se ignoran.
Observaciones

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

En todos los casos, la operación de navegación debe haber sido inicializada por una de las siguientes funciones: HReadFirst, HFirst, HReadSeekFirst, HSeekFirst, HChangeKey, HRestorePosition.
Si la posición utilizada es una posición clave:
  • si la constante hDistinct no está activa, la función HBackward permite retroceder <Intervalo> valores de la clave a partir de la posición actual.
  • si la constante hDistinct está activada, HBackward se desplaza hacia atrás de <Paso> valores de clave distintos desde la posición actual. Si se encuentran duplicados, se lee un solo duplicado.
Si el elemento utilizado no es un elemento clave:
  • la constante hDistinct no está disponible,
  • La función HBackward permite retroceder <Intervalo> registros activos a partir de la posición actual.

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 HReadSeekLast debe ignorarse (HReadSeekFirst debe utilizarse para las búsquedas realizadas por HFound, HFound, HReadSeek).
  • El número actual de Record es devuelto por HRecNum.
  • HBackward respeta el filtro activo actual (definido por HFilter).
  • HChangeKey se utiliza para modificar la clave de búsqueda mientras se posiciona en el record actual.
  • HBackward(Cliente,Nombre) es equivalente a HReadPrevious(Cliente,Nombre)
WINDEVWEBDEV - Código ServidorReportes y ConsultasUniversal Windows 10 AppiPhone/iPadJavaCódigo de Usuario (UMC)Lenguaje ExternoAjaxHFSQL ClassicHFSQL Client/ServerHyper File 5.5OLE DBConectores Nativos

Cierre

Por defecto (no se especifica el bloqueo Variable), el bloqueo realizado corresponde al modo de bloqueo actual.
Si se solicita un bloqueo (constantes hLockWrite o hLockReadWrite), se leerá y bloqueará el registro solo si este aún no ha sido bloqueado por otra aplicación.
Componente: wd290hf.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

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