|
|
|
|
- Campo de navegación
- Consultas de navegación
- Bloqueos
- Memos
- Contraseña
- Conector Nativo XML
- Varios
<Fuente>.ReadFirst (Función)
No disponible con este tipo de conexión
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 campo Nombre del archivo de datos Cliente). Los valores del campo de navegación se leen en orden ascendente (para obtener más información, consulte las observaciones). En la mayoría de los casos, <Fuente>.ReadFirst se usa para establecer la posición en el archivo de datos para realizar un ciclo de lectura con <Fuente>.ReadNext 3000300030002f002300 . Después de llamar a la función <Fuente>.ReadFirst, 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 leer una Record que ya está bloqueada 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.
Customer.ReadFirst(Name) WHILE Customer.Out() = False // Process the record Customer.ReadNext(Name) END
Sintaxis
<Result> = <Source>.ReadFirst([<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 el bucle de el archivo de datos o la vista (este parámetro es ignorado por las consultas). Si no se especifica este nombre, la función <Fuente>.ReadFirst 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.
- Para una consulta: 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 opcional Permite configurar:- el bloqueo establecido en el Record leído por <Fuente>.ReadFirst
- si se debe tener en cuenta el filtro definido.
| | hForwardOnly | | hKeepFilter | El 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 en archivos de datos demasiado grandes.
| hLockNo | Sin bloqeuo: el Record puede ser leído o modificado por otra aplicación durante la lectura.
| hLockReadWrite | Bloqueo de lectura y escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación.
| hLockWrite | Bloqueo de escritura: el registro leído actualmente puede ser leído por otra aplicación, pero no se puede modificar.
| hNoRefresh | |
Observaciones Campo de navegación Si el elemento de navegación utilizado es una clave, la función <Fuente>.ReadFirst lee el registro con el valor de clave más bajo. El criterio de ordenación que se tiene en cuenta es el especificado en el análisis para esta clave. Si se encuentran duplicados, <Fuente>.ReadFirst 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 <Fuente>.ReadFirst 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 se mostrará una advertencia en la pantalla de "Panel "Código. 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). Contraseña Si <Fuente>.ReadFirst 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, HErrorPassword devuelve True y <Fuente>.Out 02f002300 devuelve 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 mejorar los primeros tiempos de búsqueda en un archivo, utilice <Fuente>.Optimize en este archivo de datos.
- Esta función reemplaza HReadFirstLock y HReadFirstNoLock , que se mantuvieron por compatibilidad con WINDEV 5.5.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|