PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE


Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • Elemento de navegación
  • Consultas de navegación
  • Bloqueos
  • memorándums
  • Contraseña
  • Conector Nativo XML
  • Varios
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
Posiciones en el primer archivo Record de acuerdo con un artículo de navegación. Se lee el registro y se actualizan las variables HFSQL (por ejemplo, Cliente.Nombre, es decir, el elemento/campo Nombre del archivo de datos Cliente).
La lectura se realiza desde el valor más bajo hasta el valor más alto de la posición de exploración (véase observaciones para más detalles).
En la mayoría de los casos, HReadFirst se utiliza para establecer la posición en el archivo de datos con el fin de realizar un bucle de lectura con HReadNext.
Pueden darse varios casos después de la llamada a HReadFirst:
  • el archivo de datos está vacía o ningún Record corresponde al filtro (definido por HFilter): no se realiza ninguna lectura y la función HOut devuelve True.
  • la función intenta leer un Record que ya está bloqueado en modo de lectura: no se realiza ninguna lectura, HErrorLock devuelve True y HOut 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 archivos de datos, vistas HFSQL o consultas.
Versiones 18 y posteriores
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Nueva funcionalidad versión 18
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Universal Windows 10 App Esta función ahora está disponible en modo Windows Store apps.
Observación: A partir de la versión 19, HFSQL es el nuevo nombre de HyperFileSQL.
Versiones 21 y posteriores
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Nueva funcionalidad versión 21
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Universal Windows 10 App Esta función ahora está disponible en modo Universal Windows 10 App.
Ejemplo
HReadFirst(Customer, Name)
WHILE HOut(Customer) = False
// Process the record
HReadNext(Customer, Name)
END
Sintaxis
<Result> = HReadFirst([<Data file> [, <Elemento de navegación>] [, <Options>]])
<Result>: Boolean
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 HFound en los demás casos (se puede leer el registro, incluso si <Resultado> devuelve False).
<Data file>: Optional character string (with or without quotes)
Nombre del archivo de datos, vista HFSQL o consulta utilizada. Si este parámetro corresponde a una cadena vacía (""), HReadFirst utilizará el último archivo de datos utilizado por la última función de gestión de HFSQL (función que comienza con "H").
<Elemento de navegación>: Optional character string (with or without quotes)
Nombre del elemento utilizado para navegar por el archivo de datos o ver (este parámetro es ignorado por las consultas). Si no se especifica este nombre, la función HReadFirst 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 elemento no existe, se utiliza automáticamente el mejor elemento de navegación.
  • For a query: el PEDIDO POR de la consulta si existe, en caso contrario el último ítem utilizado.
  • Para una vista: la posición de clasificación de la vista (si existe); de lo contrario, la última posición utilizada.
<Options>: Optional constant
Permite configurar:
  • el bloqueo realizado en el Record leído por HReadFirst
  • si se debe tener en cuenta el filtro definido.
hLockNoSin bloqueo (incluso si se ha llamado HStartLock): el Record puede ser leído o modificado por otra aplicación durante la lectura.

Java Acceso con JDBC: Esta constante no está disponible.
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.

Java Acceso con JDBC: Esta constante no está disponible.
hLockReadWriteBloqueo de lectura/escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación.
OLE DB Bloquear en sólo escritura. Equivale a la constante hLockWrite.


Java Acceso con JDBC: Esta constante no está disponible.
Versiones 17 y posteriores
hForwardOnly
Nueva funcionalidad versión 17
hForwardOnly
hForwardOnly
Conectores Nativos Esta constante sólo se puede utilizar con Conectores Nativos.
Se utiliza para acelerar la búsqueda de datos durante una búsqueda simple que no utiliza las siguientes funciones:
  • 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.
Esta constante se puede utilizar, por ejemplo, durante una búsqueda utilizada para llenar una memoria tabla.
hKeepFilterLa navegación tendrá en cuenta el filtro establecido con la función HFilter, incluso si la clave de búsqueda no está optimizada para el filtro. Recordatorio: la función HFilter devuelve la clave de búsqueda optimizada para el filtro.
Atención: en este caso, pueden surgir problemas de rendimiento en archivos de datos demasiado grandes.
Hyper File 5.5 Esta constante no se puede utilizar.
hNoRefresh
OLE DBConectores Nativos La función HReadFirst 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.
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.
OLE DB El modo de bloqueo especificado con la función HReadFirst seguirá siendo efectivo al llamar a las funciones HReadPrevious y HReadNext.
Para modificar el bloqueo de teclas, debe utilizar:
Conectores Nativos Para Conector Nativo Oracle, se puede especificar un modo de bloqueo diferente para cada Record. Sin embargo, si una transacción fue iniciada por SQLTransaction antes de establecer el bloqueo, éste sólo se liberará al final de la transacción (SQLTransaction asociado con sqlCommit o sqlRollBack).
Hyper File 5.5 Las opciones de bloqueo se ignoran. Utilice las funciones de lectura de bloqueo (HReadFirstLock) guardadas para la compatibilidad con versiones anteriores.
Java Acceso con JDBC: La gestión de las cerraduras no está disponible para las bases de datos a las que accede el JDBC.
Observaciones

Elemento de navegación

Si el elemento de navegación utilizado es una clave, la función HReadFirst lee el registro con el valor de clave más bajo. El orden de clasificación es el que se especificó en el análisis para esta clave. Si se encuentran duplicados, HReadFirst lee el primer registro "duplicado" según el orden de los números de registro.
Si el elemento de navegación no es una clave, la función HReadFirst lee el primer registro activo. Al navegar por el archivo, los Record 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 aparecerá un aviso en la "Panel"Código.
Observación: El completado automático propone únicamente los elementos clave.
WINDEVOLE DBConectores Nativos

Consultas de navegación

Por Default, HReadFirst vuelve a realizar la consulta a actualización el resultado. Se recomienda utilizar la constante hNoRefresh para no volver a ejecutar la consulta.
Browsing a query run with the hQueryWithoutCorrection constant:
Para examinar los registros en el orden en que fueron devueltos por la base de datos, no es necesario especificar un elemento de búsqueda. Ejemplo:
HExecuteQuery(MyQuery, hQueryWithoutCorrection)
...
HReadFirst(MyQuery, hNoRefresh)
Isi se especifica un elemento de la búsqueda, el resultado de la misma se recupera y se indexa en su totalidad. La búsqueda se realiza en el elemento especificado. Se ignora el orden inicial de la consulta (especificado por ORDER BY).. El índice creado (en formato HFSQL) es sensible al caso, a la puntuación, a los caracteres acentuados y en orden ascendente.
Ejemplo:
HExecuteQuery(MyQuery, hQueryWithoutCorrection)
...
HReadFirst(MyQuery, MyItem, hNoRefresh)
El índice creado se utiliza para realizar búsquedas en el resultado de la consulta.
WINDEVUniversal Windows 10 AppCódigo de Usuario (UMC)Lenguaje ExternoHFSQLHFSQL 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.
No es necesario especificar un parámetro de bloqueo si el archivo de datos está bloqueado por HStartLock: el bloqueo especificado por HStartLock se tiene en cuenta automáticamente. Para ignorar el bloqueo especificado por HStartLock, use la constante hLockNo.
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.

memorándums

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 lectura de automatic.
Si los memos están soportados, los memos de texto de associated se leen cuando se lee el Record. Los memorándums binarios se leen sólo cuando se usan explícitamente (HExtractMemo).

Contraseña

Si la función HReadFirst es la primera función que manipula el archivo de datos especificado, la contraseña se verifica al abrir el archivo de datos. Si la contraseña es incorrecta, HErrorPassword devuelve True y HOut devuelve True.
WINDEVWindowsCódigo de Usuario (UMC)Procedimientos almacenadosConectores Nativos

Conector Nativo XML

El comportamiento de la función HReadFirst depende de las funciones HActivateAutoFilter/HDeactivateAutoFilter.
HActivateAutoFilter está habilitado por Default.
Por lo tanto, para leer el contenido del archivo XML, lea el contenido del archivo principal (el padre) y luego lea el contenido de los archivos relacionado (los hijos).
Cuando se lee un archivo de datos, se aplica automáticamente un filtro a los archivos de datos de relacionado para leer sólo los registros correspondientes al archivo principal.
Por ejemplo:
TEl Email de esta persona puede ser recuperado al navegar por el archivo de la persona.
Para ello, simplemente set la posición en el archivo "Persona" y aplicar HReadFirst al archivo "Email".
En este caso, la Record leída en el archivo "Correo electrónico" corresponderá al primer correo electrónico asociado con la Record actual en el archivo "Persona".
Si este mecanismo está desactivado (HDeactivateAutoFilter), el Record leído en el archivo "Email" corresponderá al primer Record que se encuentre en el archivo "Email" (y no al hijo del Record leído en el archivo "Persona").

Varios

  • El número actual de Record es devuelto por HRecNum.
  • HChangeKey se utiliza para modificar la clave de búsqueda mientras permanece posicionado en el Record actual.
  • Para mejorar los primeros tiempos de navegación en un archivo, usa HOptimize en este archivo de datos.
Componente : wd250hf.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