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
  • Reiniciación de posiciones
  • Varios
  • Principio de reposicionamiento para Conectores Nativos (también llamado Native Access)
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
HRestorePosition (Función)
ODBCNo disponible con este tipo de conexión
Restablece el contexto previamente guardado de un archivo de datos (HSavePosition): registro actual, filtro, punteros.
La función HRestorePosition permite restaurar:
  • el número de la Record utilizada,
  • los diferentes punteros del índice (la posición en el índice se guarda para cada tecla),
  • el filtro actual (solo si se especifica la constante hRPFilter).
Esta función se puede utilizar con archivos de datos, vistas HFSQL o consultas.
Ejemplo
// Find a record
HReadSeekFirst(Customer, Name, Name)
WHILE HFound(Customer) = True
// Saves the current context
nPos = HSavePosition(Customer, Name)
// Check a customer with another name
HReadSeek(Customer, Name, Name2)
IF HFound() = True THEN Counter = Counter + 1
// Restores the context
HRestorePosition(nPos)
HReadNext(Customer, Name)
END
Sintaxis

Restablecer la posición especificada Ocultar los detalles

<Result> = HRestorePosition(<Position> [, <Option>])
<Result>: booleano
  • True si se restauró la posición especificada,
  • False en caso contrario. La función HError permite obtener más detalles sobre el problema.
<Position>: Integro
Posición a restaurar. Valor devuelto por HSavePosition.
<Option>: Constante o combinación de constantes opcional
Permite configurar la operación de restauración:
hRPDefault
(valor predeterminado)
La posición se libera. Se restablece la posición almacenada.
hRPFilterRestablece el filtro implementado durante la llamada a HSavePosition.
hRPHF5Si se ha borrado o modificado la posición memorizada, esta posición se restablece..
Si no se especifica la constante hRPHF5 y se realiza la copia de seguridad en varios elementos, el posicionamiento se establece en el número de registro en curso al momento de llamar a la función HSavePosition.
PHP Esta constante no está soportada.

Java Acceso con JDBC: Esta constante no está soportada.
hRPKeepLa posición no se libera (se podrán realizar otras llamadas a la función HRestorePosition en esta posición).
Hyper File 5.5 Este parámetro no se tiene en cuenta: la posición se guardará para todos los elementos que se recorran en bucle.

Restauración de un archivo de datos Ocultar los detalles

<Result> = HRestorePosition([<Data file>])
<Result>: booleano
  • True si el contexto ha sido restaurado,
  • False en caso contrario. La función HError permite obtener más detalles sobre el problema.
<Data file>: Cadena de caracteres opcional
Nombre del archivo de datos cuyo contexto debe ser restaurado. Si no se especifica este nombre, la función HRestorePosition utilizará el último archivo de datos utilizado por la última función HFSQL (que empieza por "H").
Observaciones

Reiniciación de posiciones

Atención: todas las funciones que abren o cierran un archivo de datos reinicializan los números de contexto (HCreation, HClose, etc.).
Si se eliminó el registro guardado con la función HSavePosition, la función HRestorePosition conserva el contexto actual pero la posición se establecerá en el registro que se encuentra después del registro eliminado.
OLE DB Al reiniciar una navegación, las posiciones guardadas en esta navegación se destruyen.. El motor HFSQL está utilizando el valor del mejor elemento para intentar un nuevo posicionamiento. La mejor posición se selecciona en el siguiente orden de preferencia:
  1. Identificador de automatic
  2. Clave única
  3. Primera llave
  4. Primer punto
Las siguientes funciones reinicializan la iteración:

Varios

  • El número de llamadas a HSavePosition no está limitado.
  • Puede anidar HSavePosition y HRestorePosition para el mismo archivo de datos.
WINDEVWEBDEV - Código ServidorConectores Nativos

Principio de reposicionamiento para Conectores Nativos (también llamado Native Access)

El Record es restaurado desde el caché interno del Conector Nativo.
Atención: Durante la operación de restauración, no se comprueba la existencia de Record en la base de datos (el Record puede haber sido borrado).
Se puede "forzar" la lectura de la base de datos utilizando la función HRead después de la función HRestorePosition. En este caso:
  • los valores de Record serán leídos de nuevo en la base de datos.
  • si el Record ha sido borrado, el Conector Nativo devolverá el error 13: No se puede encontrar el actual Record. Se modificó o eliminó de la fuente de datos.
Casos especiales: Conectores nativos MySQL, DB2 e Informix: Tras la llamada a HRestorePosition, HReadNext y HReadPrevious se genera una consulta para encontrar el Record siguiente o anterior al Record restaurado.
Clasificación Lógica de negocio / UI: Lógica de negocio
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