CDaoRecordset::FindNext

BOOL FindNext (LPCTSTR lpszFilter );
lançar (CDaoException, CMemoryException);

Valor de retorno

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

Parâmetros

lpszFilter

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

Observações

Chame essa função de membro para localizar o próximo registro que corresponde a uma condição especificada. A função de membro de FindNext começa sua pesquisa no registro atual e procura até o final do conjunto de registros.

Se você quiser incluir todos os registros na sua busca (não apenas aqueles que atendem uma condição específica) usam um das operações de mover para mover de um registro para outro. Para localizar um registro em um recordset tipo tabela, chamar a função de membro Seek.

Se um registro que correspondem os critérios não for localizado, o ponteiro do registro atual é indeterminado e FindNext retorna zero. Se o conjunto de registros contém mais de um registro que satisfaz os critérios, que FindFirst localiza a Primeiro ocorrência, FindNext localiza a próxima ocorrência e assim por diante.

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

Usando um das operações de localizar não é o mesmo que chamar MoveFirst ou MoveNext, entretanto, que simplesmente faz o primeiro ou o próximo registro atual sem especificar uma condição. Você pode acompanhar uma operação de localizar com uma operação de movimentação.

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

• Se Localizar retorna diferente de zero, o registro atual não está definido. Nesse caso, você deve posicionar o ponteiro do registro atual para um registro válido.
  
  
• Você não pode usar uma operação de localizar com um recordset do tipo snapshot rolagem Avançar-only.
  
  
• Você deve usar o formato de data americano (mês-dia-ano) quando você pesquisa para campos que contêm datas, mesmo se você não estiver usando a versão americana do mecanismo de banco de dados do Microsoft Jet; caso contrário, registros correspondentes não podem ser encontrados.
  
  
• Ao trabalhar com bancos de dados ODBC e dynasets grande, você pode descobrir que o uso das operações de localizar é lenta, especialmente quando se trabalha com grandes conjuntos de registros. Você pode melhorar o desempenho usando SQL consultas com cláusulas ORDER BY ou onde personalizadas, consultas de parâmetro ou CDaoQuerydef objetos que recuperar registros indexados específicos.

Para obter mais informações sobre como localizar registros, consulte o artigo DAO Recordset: navegação do conjunto de registros no Guia do programador do Visual C++. Para obter informações relacionadas, consulte o tópico "FindFirst, FindLast, FindNext, FindPrevious métodos" na Ajuda do DAO.

Visão geral de CDaoRecordset |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CDaoRecordset::Find, CDaoRecordset::FindFirst, CDaoRecordset::FindLast, CDaoRecordset::FindPrev