CDaoRecordset::FindFirst

BOOL FindFirst (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 primeiro registro que corresponde a uma condição especificada. A função de membro FindFirst começa sua pesquisa desde o início do conjunto de registros e pesquisas para 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 FindFirst 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 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.

As funções de membro encontrar pesquisa do local e na direção especificada na tabela a seguir:

Operações de localizar Começar Direção da pesquisa
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

Importa&ntenbsp;  Quando você chamar FindLast, o mecanismo de banco de dados do Microsoft Jet preenche totalmente seu conjunto de registros antes de iniciar a pesquisa, se isso já não foi feito. A primeira busca pode demorar mais do que buscas subsequentes.

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:

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 CDaoRecordsetMembros de classe | Gráfico de hierarquia

Consulte tambémnbsp;CDaoRecordset::Find, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev

Index