CDaoRecordset::FindFirst

telefonar 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 de caracteres (como a ONDE cláusula uma demonstrativo SQL sem a palavra ONDE) usado para localizar o registro.

Valor de retorno

Diferente de zero se registros correspondentes forem encontrados, caso contrário, 0.

Comentários

The FindFirst função de membro inicia a Pesquisar do início do conjunto de registros e pesquisas para o participante do conjunto de registros.

Se você desejar incluir todos os registros na Pesquisar (não apenas aqueles que atendem uma condição específica) use um das operações de movimentação para mover de um registro para outro.Para localizar um registro em um conjunto de registros do tipo tabela telefonar o Seek função de membro.

Se um registro que correspondem aos critérios não for localizado, o registro corrente ponteiro é indeterminado e FindFirst Retorna zero. Se o conjunto de registros contém mais de um registro que satisfaça aos critérios, FindFirst Localiza a primeira ocorrência FindNext Localiza a próxima ocorrência e assim por diante.

Cuidado:

Se você edição o registro corrente, certifique-se de salvar as alterações, chamando o Atualizaçãofunção de membro antes de mover para um outro registro.Se você mover para um outro registro sem atualizar, suas alterações serão perdidas sem aviso.

The Localizarfunções de membro Pesquisar do local e na direção especificada na tabela a seguir:

Localizar operações

Começar

Direção da Pesquisar

FindFirst

Início do conjunto de registros

participante do conjunto de registros

FindLast

participante do conjunto de registros

Início do conjunto de registros

FindNext

Registro corrente

participante do conjunto de registros

FindPrevious

Registro corrente

Início do conjunto de registros

Observação:

Quando você chama FindLast, o mecanismo de banco de dados Microsoft Jet totalmente preenche o conjunto de registros antes de iniciar a Pesquisar, se isso já não tenha sido concluído. A primeira Pesquisar pode demorar mais do que pesquisas subseqüentes.

Usar uma das operações de localização não é o mesmo sistema autônomo chamando MoveFirst or MoveNext, no entanto, que simplesmente torna o primeiro ou próximo registro corrente sem especificar uma condição. Você pode seguir uma operação de localizar com uma operação de movimentação.

Tenha em mente o seguinte ao usar as operações de localização:

  • If Localizar retorna diferente de zero, o registro corrente não está definido.Nesse caso, você deve posicionar o ponteiro do registro corrente para um registro válido.

  • Não é possível usar uma operação de localizar com um encaminhar-only rolagem instantâneo do conjunto de registros do tipo.

  • Você deve usar os EUAformato de data (mês-dia-ano) quando você procura campos que contêm datas, mesmo se você estiver usando não EUA.a versão do mecanismo de banco de dados Microsoft Jet; caso contrário, registros coincidentes podem não ser encontrado.

  • Ao trabalhar com bancos de dados ODBC e dynasets grande, você pode descobrir que usar as operações de localização é lento, especialmente quando se trabalha com grandes conjuntos de registros.You can improve performance by using SQL queries with customized ORDER BY or WHERE clauses, parameter queries, or CDaoQuerydef objects that retrieve specific indexed records.

Para obter informações relacionadas, consulte o tópico "FindFirst, FindLast, FindNext FindPrevious métodos" na Ajuda do DAO.

Requisitos

Cabeçalho: afxdao.h

Consulte também

Referência

Classe CDaoRecordset

Gráfico de hierarquia

CDaoRecordset::Find

CDaoRecordset::FindLast

CDaoRecordset::FindNext

CDaoRecordset::FindPrev

Outros recursos

CDaoRecordset membros