Compartilhar via


CDaoRecordset::FindNext

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

BOOL FindNext( 
   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 FindNext começa sua pesquisa no registro atual e em pesquisas 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 FindNext . 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.

Aviso

Se você editar o registro atual, certifique-se que você salve 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.

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.

Para informações relacionadas, consulte o tópico “FindFirst, FindLast, FindNext, métodos de FindPrevious” na ajuda de DAO.

Requisitos

Cabeçalho: afxdao.h

Consulte também

Referência

Classe CDaoRecordset

Gráfico da hierarquia

CDaoRecordset::Find

CDaoRecordset::FindFirst

CDaoRecordset::FindLast

CDaoRecordset::FindPrev