- Búsqueda genérica/búsqueda por coincidencia de datos de salida
- Búsqueda realizada sobre un elemento clave o sobre un elemento no clave
- Realizar una búsqueda en una clave compuesta
- Buscar en un artículo de array
- Buscar y filtrar
- Navegar por los registros correspondientes a una condición
- Búsqueda por coincidencia exacta en Access
- Bloqueos
- Optimización de las operaciones de navegación
- Conector Nativo XML
<Fuente>.ReadSeekFirst (Función)
No disponible con este tipo de conexión
Posiciones en la primera Record de un archivo de datos cuyo valor para un artículo específico es estrictamente igual al valor buscado (búsqueda de coincidencia exacta). El Record se lee y las variables correspondientes HFSQL se actualizan. En la mayoría de los casos, <Fuente>.ReadSeekFirst se utiliza para establecer la posición en el archivo de datos para realizar un bucle de navegación entre los registros que corresponden a una condición. <Fuente>.ReadNext se usa para leer el siguiente Record correspondiente a la condición. Pueden darse varios casos después de la llamada a <Fuente>.ReadSeekFirst: - a Record correspondiente a la condición se encontró, bloqueado (si es necesario) y cargado en la memoria: <Fuente>.Found devuelve True.
- si no existe ningún registro que corresponda a la condición, pero existe un registro de mayor valor: se lee el registro, la función <Fuente>.Out devuelve False y la función <Fuente>.Found devuelve False.
- el archivo de datos está vacío: no se realiza ninguna operación de lectura, <Fuente>.Out devuelve True y <Fuente>.Found devuelve False.
- la función intenta bloquear un registro ya bloqueado en modo de lectura: no se realiza ninguna operación de lectura, HErrorLock devuelve True y <Fuente>.Out devuelve True.
Observación: Por defecto, se realiza una gestión automática de errores de bloqueo y de conflictos de modificación (excepto en el código de procedimientos almacenados). La gestión automática de errores se puede personalizar o desactivar en cualquier momento con la función <Fuente>.OnError.
La función <Fuente>.ReadSeekFirst puede utilizarse con archivos de datos, vistas HFSQL o consultas. Versiones 15 y posteriores Nueva funcionalidad versión 15 Versiones 17 y posteriores Nueva funcionalidad versión 17 Versiones 18 y posteriores Nueva funcionalidad versión 18 Observación: A partir de la versión 19, HFSQL es el nuevo nombre de HyperFileSQL. Versiones 21 y posteriores Nueva funcionalidad versión 21
// Find the first record for which // the Customer name is MOORE Customer.ReadSeekFirst(Name, "MOORE") IF Customer.Found() = False THEN Error("Customer not found") RETURN ELSE // Continue the process on the customer named MOORE END
Sintaxis
<Result> = <Source>.ReadSeekFirst(<Item> , <Sought value> [, <Options>])
<Result>: Booleano - True si se encontró el Record (corresponde al valor devuelto por <Fuente>.Found).
- False si se produce un problema. Este problema puede ser causado por:
- un problema de posicionamiento (archivo de datos vacío, ...): <Fuente>.Found devuelve False y HError devuelve 0.
- un error: HError devuelve un número entero distinto de 0. HErrorInfo devuelve más detalles.
<Source>: Tipo de fuente especificada Nombre del archivo de datos HFSQL, vista o consulta utilizada. <Item>: Cadena de caracteres (con o sin comillas) Nombre del artículo sobre el que se realizará la búsqueda. Este elemento puede ser o no una clave de búsqueda.
<Sought value>: Tipo de valor Valor del artículo buscado. <Options>: Constante o combinación de constantes opcional Permite configurar:- el modo de bloqueo aplicado al buscado Record
- el tipo de búsqueda realizada.
| | hLockReadWrite | Bloqueo de lectura/escritura: el Record que se lee actualmente no puede ser leído o modificado por otra aplicación. El bloqueo de teclas se ignora si se utiliza una consulta.
| 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. El bloqueo de teclas se ignora si se utiliza una consulta.
| hLockNo | Sin bloqueo (incluso si se llamó a HStartLock): el Record puede ser leído o modificado por otra aplicación durante la lectura.
| Versiones 17 y posterioreshForwardOnly Nueva funcionalidad versión 17hForwardOnly hForwardOnly | | hGeneric | Búsqueda genérica (ver las Notas) Una búsqueda de coincidencia exacta es realizada por Default (constante no especificada). | hLimitParsing | La navegación se detendrá tan pronto como se encuentre el último valor buscado o si ningún valor corresponde a la búsqueda.. El actual Record corresponderá a este último Record encontrado. <Fuente>.Found devolverá False y <Fuente>.Out devolverá True. Esta constante se utiliza para optimizar la velocidad de búsqueda en el modo Cliente/Servidor y en las bases de datos externas (accesibles a través de OLE DB o a través de Conectores Nativos). | hKeepFilter | El filtro set de <Fuente>.Filter será tenido en cuenta, incluso si 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. By Default, la búsqueda realizada después de <Fuente>.ReadSeekFirst ignora el filtro. | hNoRefresh | |
Observaciones Búsqueda genérica/búsqueda por coincidencia de datos de salida - Búsqueda genérica (principalmente en las posiciones de la cadena de caracteres): Busca todos los registros que empiezan con el valor especificado.
Por ejemplo: Cuando se realiza una búsqueda genérica en "Smith" (para el elemento NAME), todos los registros cuyo elemento Name comience con "Smith" coincidirán con la búsqueda. Por lo tanto, el Record que contiene "Smither" coincidirá con la búsqueda (<Fuente>.Found devuelve True). Observación: Para la compatibilidad con WINDEV 5.5, la búsqueda genérica de una cadena vacía ("") es equivalente al uso de la función <Fuente>.ReadFirst. - Búsqueda de coincidencia de fecha exacta : Busca todos los registros que coinciden exactamente con el valor especificado..
Por ejemplo: Cuando se realiza una búsqueda de coincidencia exacta en "Smith" (para el elemento NOMBRE), <Fuente>.Found devuelve True para los registros cuyo elemento coincide exactamente con "Smith". - Ejemplos de búsquedas realizadas en el archivo CLIENTE ordenado por nombre:
 | | | | | | Valor buscado | Opciones | <Fuente>.ReadSeekFirst establece la posición sobre el Record. | Devoluciones de <Fuente>.Found | Devoluciones de <Fuente>.Out | Explicaciones | De los cuales | | 1 | True | False | De los cuales existen. El final del archivo de datos no se ha alcanzado todavía. | Davo | | 1 | False | False | Davo no existe. Posición en el primer valor mayor (Davon). El final del archivo de datos no se ha alcanzado todavía. | Moro | hGeneric | 8 | True | False | Moor no existe pero la búsqueda es genérica y se encuentra Moore (entre otros). El final del archivo de datos no se ha alcanzado todavía. | Moro | | No se encontró el Record (no hay movimiento, el Record actual no cambia). | False | False | El moro no existe. El final del archivo de datos no se ha alcanzado todavía. | Norbert | | No se encontró el Record (no hay movimiento, el Record actual no cambia). | False | True | Norbert no existe. Posición en el primer valor mayor (este valor no existe): se ha llegado al final del archivo de datos. |
Vea el Hyper File 5.5 y 7: ¿Cómo gestionar los caracteres de espacio en las búsquedas? tabla para más detalles Búsqueda realizada sobre un elemento clave o sobre un elemento no clave La búsqueda se puede realizar en un elemento clave o no clave. Si la búsqueda se realiza en un elemento clave: - la búsqueda es rápida y el resultado está ordenado.
- si la navegación es continuada por <Fuente>.ReadNext, los siguientes registros corresponderán a los valores mayores o iguales al valor buscado. En este caso, <Fuente>.Out debe ser revisado después de cada operación de lectura para saber si se ha llegado al final del archivo de datos.
Si la búsqueda se realiza en un elemento no clave: Realizar una búsqueda en una clave compuesta Se pueden utilizar varios métodos para realizar una búsqueda en una clave compuesta: 1. Utilizando una lista de valores . La siguiente sintaxis se utiliza para realizar una búsqueda en una clave compuesta:
HReadSeekFirst(<File Name>, <Name of Composite Key>, [<Search value of first element of composite key>, <Search value of first element of composite key>, ...])
Ejemplo:
// Find the record Customer.ReadSeekFirst(LastName_FirstName, ["MOORE", "Vince"])
2. Uso de <Fuente>.BuildKeyValueEjemplo:
bufSoughtVal is Buffer = Customer.BuildKeyValue(LastName_FirstName, sLastName, sFirstName) Customer.SeekFirst(LastName_FirstName, bufSoughtVal) WHILE Customer.Found() Customer.Delete() Customer.Next(LastName_FirstName) END
3. Uso de HConvert- llenar los componentes del texto en su tamaño completo con Charact( 0).
- convertir los componentes numéricos con la función HConvert.
Ejemplo:
MyCompositeKey = Complete(Customer.CustomerLastName, Dimension(Customer.LastName), Charact(0)) + ... Complete(Customer.FirstName, Dimension(Customer.FirstName), Charact(0))
Buscar en un artículo de array La búsqueda se realiza en el primer elemento array (elemento cuyo índice es 1). Para realizar una búsqueda en los otros elementos de array, utilice los filtros o consultas. Buscar y filtrar Si un filtro está activado ( <Fuente>.Filter), el filtro es tenido en cuenta por la búsqueda sólo si la clave utilizada es idéntica. Para tener en cuenta este filtro en el resto de la navegación (incluso si la clave de búsqueda no está optimizada para el filtro), utilice la constante hKeepFilter.
Navegar por los registros correspondientes a una condición En la mayoría de los casos, <Fuente>.ReadSeekFirst se utiliza para establecer la posición en el archivo de datos para realizar un bucle de navegación entre los registros que corresponden a una condición. <Fuente>.ReadNext y <Fuente>.ReadPrevious se utilizan para leer los registros siguientes y anteriores correspondientes a la condición. Para ignorar la búsqueda mientras se va a la siguiente o anterior Record, utilice una de las siguientes funciones:
Esta página también está disponible para…
|
|
|