CDaoRecordset::FindFirst

Artigo
02/25/2013

Chamar essa função de membro para localizar o primeiro registro que corresponde a uma condição especificada.

BOOL FindFirst(
   LPCTSTR lpszFilter 
);

Parâmetros

lpszFilter
Uma expressão de cadeia de caracteres (como a cláusula de WHERE em uma instrução SQL sem a palavra WHERE) usado para localizar o registro.

Valor de retorno

Diferente de zero se combinando os registros são encontrados, se não 0.

Comentários

A função de membro de FindFirst começa sua pesquisa do início do conjunto de registros e procura ao final do conjunto de registros.

Se você deseja incluir todos os registros em sua pesquisa (não apenas aqueles que estão de acordo com uma condição específica) usa uma das operações de animação para mover a partir do registro no registro.Para localizar um registro em um conjunto de registros da tabela de tipo, chame a função de membro de Seek .

Se um registro que corresponde aos critérios não for encontrado, o ponteiro de registro atual é retorna zero indefinidas, e de FindFirst .Se o recordset contém mais de um registro que satisfaz os critérios, FindFirst localiza a primeira ocorrência, FindNext localiza a próxima ocorrência, e assim por diante.

Cuidado
Se você editar o registro atual, certifique-se de salvar as alterações chamando a função de membro de Atualizar antes que você irá transmitir a outro registro.Se você move para outro registro sem atualizar, suas alterações são perdidas sem aviso.

As funções de membro de Localizar pesquisam local e na direção especificada na tabela a seguir:

Operações de localização	Inicie	Procure a direção
FindFirst	Início do conjunto de registros	Final do conjunto de registros
FindLast	Final do conjunto de registros	Início do conjunto de registros
FindNext	Registro atual	Final do conjunto de registros
FindPrevious	Registro atual	Início do conjunto de registros

Observação
Quando você chama FindLast, o mecanismo de banco de dados Microsoft Jet preenche completamente o conjunto de registros antes de iniciar a pesquisa, se esse não tiver sido feito já.A primeira pesquisa pode levar mais tempo pesquisas de que subseqüentes.

Usar uma das operações de localização não é a mesma que chamar MoveFirst ou MoveNext, entretanto, que faz somente a primeira ou atual próximo registro sem especificar uma condição.Você pode seguir uma operação de localização com uma operação de animação.

Manter o seguinte em mente quando usar as operações de localização:

Se Localizar retorna diferente de zero, o registro atual não está definido.Em esse caso, você deve posicionar o ponteiro de registro atual de volta a um registro válido.
Você não pode usar uma operação de localização com um recordset somente para frente de instantâneo- tipo de rolagem.
Você deve usar o formato de data U.S. (mês-dia-ano) quando você procurar pelos campos que contêm datas, mesmo se você não estiver usando a versão U.S. do mecanismo de banco de dados Microsoft Jet; se não corresponder, registros não pode ser encontrado.
A o trabalhar com bancos de dados ODBC e grandes dynasets, você pode descobrir que usar as operações de localização é lenta, especialmente ao trabalhar com grandes conjuntos de registros.Você pode melhorar o desempenho usando consultas SQL com PEDIDOpersonalizadoBY ou cláusulas de WHERE , consultas de parâmetro, ou objetos de CDaoQuerydef que recuperam registros indexados específico.