Find (método) (ADO)

Busca en un objeto Recordset la fila que cumple los criterios especificados. Opcionalmente, se puede especificar la dirección de la búsqueda, la fila inicial y el desplazamiento desde la fila inicial. Si se cumple el criterio, la posición de fila actual se establece en el registro encontrado; de lo contrario, la posición se establece en el final (o inicio) del objeto Recordset.

Sintaxis

  
Find (Criteria, SkipRows, SearchDirection, Start)  

Parámetros

Criterios
Valor de tipo String que contiene una instrucción que especifica el nombre de columna, el operador de comparación y el valor que se va a usar en la búsqueda.

SkipRows
Opcional. Valor Long, cuyo valor predeterminado es cero, que especifica el desplazamiento de fila a partir de la fila actual o del marcador Start para iniciar la búsqueda. De manera predeterminada, la búsqueda empezará en la fila actual.

SearchDirection
Opcional. Valor SearchDirectionEnum que especifica si la búsqueda debe comenzar en la fila actual o en la siguiente fila disponible en la dirección de la búsqueda. Una búsqueda incorrecta se detiene al final del objeto Recordset si el valor es adSearchForward. Una búsqueda incorrecta se detiene al principio del objeto Recordset si el valor es adSearchBackward.

Iniciar
Opcional. Marcador Variant que funciona como posición inicial de la búsqueda.

Comentarios

Solo se puede especificar un nombre de una sola columna en la propiedad Criteria. Este método no admite búsquedas en varias columnas.

El operador de comparación de Criteria puede ser ">" (mayor que), "<" (menor que), "=" (igual), ">=" (mayor que o igual), "<=" (menor que o igual), "<>" (no igual), or "like" (coincidencia de patrones).

El valor de Criteria puede ser una cadena, un número de punto flotante o una fecha. Los valores de cadena se delimitan con comillas simples o marcas "#" (signo de número) (por ejemplo, "state = 'WA'" o "state = #WA#"). Los valores de fecha se delimitan con marcas "#" (signo de número) (por ejemplo, "start_date > #7/22/97#"). Estos valores pueden contener horas, minutos y segundos para indicar marcas de tiempo, pero no deben contener milisegundos ni se deben producir errores.

Si el operador de comparación es "like", el valor de cadena puede contener un asterisco (*) para buscar una o varias repeticiones de cualquier carácter o subcadena. Por ejemplo, "state like 'M*'" coincide con Maine y Massachusetts. También puede usar asteriscos iniciales y finales para buscar una subcadena contenida en los valores. Por ejemplo, "state like '*as*'" coincide con Alaska, Arkansas y Massachusetts.

Los asteriscos solo se pueden usar al final de una cadena de criterios, o bien al principio y al final de una cadena de criterios, como se mostró anteriormente. No se puede usar el asterisco como un carácter comodín inicial ('*str') o como un comodín incrustado ('s*r'). Esto provocará un error.

Nota

Se producirá un error si no se establece una posición de fila actual antes de llamar a Find. Se debe llamar a cualquier método que establezca la posición de fila, como MoveFirst, antes de llamar a Find.

Nota

Si llama al método Find en un objeto Recordset y la posición actual de dicho objeto está en el último registro o al final del archivo (EOF), no encontrará nada. Debe llamar al método MoveFirst para establecer la posición o el cursor actuales al principio del conjunto de registros.

Se aplica a

Objeto de conjunto de registros (ADO)

Consulte también

Ejemplo del método Find (VB)
Propiedad Index
Propiedad dinámica Optimize (ADO)
El método de búsqueda