|
|
|
|
- Lectura o no de la operación según un elemento clave
- Memos
- Varios
- Cierre
HBackward (Función)
No disponible con este tipo de conexión
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.
Esta función se puede utilizar con archivos de datos, vistas HFSQL o consultas. // 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").
<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.
| | 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. |
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.
| | hDistinct | Cuando se realiza una búsqueda en un elemento clave, se busca un solo Record si se encuentran duplicados. |
Observaciones Lectura o no de la operación según un elemento clave 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)
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|