Classe CDaoRecordset

Artigo
06/10/2015

Representa um conjunto de registros selecionados de uma fonte de dados.

class CDaoRecordset : public CObject

Membros

Construtores public

Nome	Descrição
CDaoRecordset::CDaoRecordset	Constrói um objeto de CDaoRecordset .

Métodos públicos

Nome	Descrição
CDaoRecordset::AddNew	Prepara-se adicionando um novo registro. Chamada Atualizar para concluir a adição.
CDaoRecordset::CanAppend	Retorna diferente de zero se os novos registros podem ser adicionados ao conjunto de registros através da função de membro de AddNew .
CDaoRecordset::CanBookmark	Retorna diferente de zero se o recordset suporta indicadores.
CDaoRecordset::CancelUpdate	Cancela todas as atualizações pendentes devido a uma operação de Editar ou de AddNew .
CDaoRecordset::CanRestart	Retorna diferente de zero se Requery pode ser chamado para executar novamente a consulta ao conjunto de registros.
CDaoRecordset::CanScroll	Retorna diferente de zero se você pode percorrer os registros.
CDaoRecordset::CanTransact	Retorna diferente de zero se a fonte de dados suportar transações.
CDaoRecordset::CanUpdate	Retorna diferente de zero se o recordset pode ser atualizado (você pode adicionar, atualizar ou excluir registros,).
CDaoRecordset::Close	Fecha o conjunto de registros.
CDaoRecordset::Delete	Exclui o registro atual do conjunto de registros. Você deve explicitamente rolar outro registro após a exclusão.
CDaoRecordset::DoFieldExchange	Chamado para trocar dados (em ambas as direções) entre os membros de dados do campo do conjunto de registros e o registro correspondente na fonte de dados. Troca do campo do registro DAO implements (DFX).
CDaoRecordset::Edit	Para prepara-se alterações para o registro atual. Chamada Atualizar para concluir a edição.
CDaoRecordset::FillCache	Preenche todo o ou parte cache local para um objeto do conjunto de registros que contém dados de uma fonte de dados ODBC.
CDaoRecordset::Find	Localiza o primeiro, próximo local, ou anterior, o último de uma cadeia de caracteres específica em um conjunto de registros de dynaset- tipo que satisfaz os critérios específicos e o torna que registra o registro atual.
CDaoRecordset::FindFirst	Localiza o primeiro registro em um conjunto de registros de dynaset- tipo ou de instantâneo- tipo que satisfaz os critérios específicos e o torna que registra o registro atual.
CDaoRecordset::FindLast	Localize o último registro em um conjunto de registros de dynaset- tipo ou de instantâneo- tipo que satisfaz os critérios específicos e o torna que registra o registro atual.
CDaoRecordset::FindNext	Localiza o registro a seguir em um conjunto de registros de dynaset- tipo ou de instantâneo- tipo que satisfaz os critérios específicos e o torna que registra o registro atual.
CDaoRecordset::FindPrev	Localiza o registro anterior em um conjunto de registros de dynaset- tipo ou de instantâneo- tipo que satisfaz os critérios específicos e o torna que registra o registro atual.
CDaoRecordset::GetAbsolutePosition	Retorna o número de registro do registro atual de um objeto do conjunto de registros.
CDaoRecordset::GetBookmark	Retorna um valor que representa o indexador em um registro.
CDaoRecordset::GetCacheSize	Retorna um valor que especifica o número de registros em um conjunto de registros de dynaset- tipo que contém os dados a serem armazenados em cache localmente de uma fonte de dados ODBC.
CDaoRecordset::GetCacheStart	Retorna um valor que especifica o indicador do primeiro registro no conjunto de registros a serem armazenados em cache.
CDaoRecordset::GetCurrentIndex	Retorna CString que contém o nome do índice usou recentemente em um indexado, com tipo CDaoRecordset.
CDaoRecordset::GetDateCreated	Retorna a data e a hora que a tabela de base subjacente um objeto de CDaoRecordset foi criada
CDaoRecordset::GetDateLastUpdated	Retorna a data e hora da alteração mais recente feita ao design de uma tabela de base subjacente um objeto de CDaoRecordset .
CDaoRecordset::GetDefaultDBName	Retorna o nome da fonte de dados padrão.
CDaoRecordset::GetDefaultSQL	Chamado para obter a cadeia de caracteres SQL padrão para executar.
CDaoRecordset::GetEditMode	Retorna um valor que indica o estado de edição para o registro atual.
CDaoRecordset::GetFieldCount	Retorna um valor que representa o número de campos em um conjunto de registros.
CDaoRecordset::GetFieldInfo	Retorna tipos específicos de informações sobre os campos no conjunto de registros.
CDaoRecordset::GetFieldValue	Retorna o valor de um campo em um conjunto de registros.
CDaoRecordset::GetIndexCount	Retorna o número de índices em uma tabela que é a base de um conjunto de registros.
CDaoRecordset::GetIndexInfo	Retorna vários tipos de informações sobre um índice.
CDaoRecordset::GetLastModifiedBookmark	Usado para determinar o registro recentemente adicionados ou atualizado.
CDaoRecordset::GetLockingMode	Retorna um valor que indica o tipo de bloqueio que é aplicado durante a edição.
CDaoRecordset::GetName	Retorna CString que contém o nome do conjunto de registros.
CDaoRecordset::GetParamValue	Recupera o valor do parâmetro atual especificado armazenado no objeto subjacente de DAOParameter.
CDaoRecordset::GetPercentPosition	Retorna a posição do registro atual como uma porcentagem do número total de registros.
CDaoRecordset::GetRecordCount	Retorna o número de registros acessados em um objeto do conjunto de registros.
CDaoRecordset::GetSQL	Obtém a cadeia de caracteres SQL usada para selecionar registros para o conjunto de registros.
CDaoRecordset::GetType	Chamado para determinar o tipo de um conjunto de registros: com tipo, dynaset- tipo, ou instantâneo- tipo.
CDaoRecordset::GetValidationRule	Retorna CString que contém o valor que valida os dados enquanto é inserido em um campo.
CDaoRecordset::GetValidationText	Recupera o texto que é exibido quando uma regra de validação não é satisfeita.
CDaoRecordset::IsBOF	Retorna diferente de zero se o conjunto de registros está posicionado antes do primeiro registro. Não há nenhum registro atual.
CDaoRecordset::IsDeleted	Retorna diferente de zero se o conjunto de registros é posicionado em um registro excluído.
CDaoRecordset::IsEOF	Retorna diferente de zero se o recordset foi posicionado após o último registro. Não há nenhum registro atual.
CDaoRecordset::IsFieldDirty	Retorna diferente de zero se o campo especificado no registro atual foi alterado.
CDaoRecordset::IsFieldNull	Retorna diferente de zero se o campo especificado no registro atual é zero (não ter nenhum valor).
CDaoRecordset::IsFieldNullable	Retorna diferente de zero se o campo especificado no registro atual pode ser definido como nulo (não ter nenhum valor).
CDaoRecordset::IsOpen	Retorna diferente de zero se Abrir tiver sido chamado anteriormente.
CDaoRecordset::Move	Posiciona o conjunto de registros a um número de registros especificado do registro atual em ambas as direções.
CDaoRecordset::MoveFirst	Posiciona o registro atual no primeiro registro no conjunto de registros.
CDaoRecordset::MoveLast	Posiciona o registro atual no último registro no conjunto de registros.
CDaoRecordset::MoveNext	Posiciona o registro atual no próximo registro no conjunto de registros.
CDaoRecordset::MovePrev	Posiciona o registro atual no registro anterior no conjunto de registros.
CDaoRecordset::Open	Cria um novo conjunto de registros de uma tabela, um dynaset, ou um instantâneo.
CDaoRecordset::Requery	Executa a consulta ao conjunto de registros novamente para atualizar os registros selecionados.
CDaoRecordset::Seek	Localiza o registro em um objeto indexado do conjunto de registros da tabela de tipo que satisfaz os critérios específicos para o índice atual e o torna que registra o registro atual.
CDaoRecordset::SetAbsolutePosition	Define o número de registro do registro atual de um objeto do conjunto de registros.
CDaoRecordset::SetBookmark	Posiciona o conjunto de registros em um registro que contém o indexador especificado.
CDaoRecordset::SetCacheSize	Define um valor que especifica o número de registros em um conjunto de registros de dynaset- tipo que contém os dados a serem armazenados em cache localmente de uma fonte de dados ODBC.
CDaoRecordset::SetCacheStart	Define um valor que especifica o indicador do primeiro registro no conjunto de registros a serem armazenados em cache.
CDaoRecordset::SetCurrentIndex	Chamado para definir um índice em um conjunto de registros da tabela de tipo.
CDaoRecordset::SetFieldDirty	Marca o campo especificado no registro atual como modificado.
CDaoRecordset::SetFieldNull	Define o valor do campo especificado no registro atual como nulo (não ter nenhum valor).
CDaoRecordset::SetFieldValue	Defina o valor de um campo em um conjunto de registros.
CDaoRecordset::SetFieldValueNull	Defina o valor de um campo em um conjunto de registros como nulo. (não ter nenhum valor).
CDaoRecordset::SetLockingMode	Define um valor que indica o tipo de bloqueio para colocar em efeito durante a edição.
CDaoRecordset::SetParamValue	Defina o valor do parâmetro atual especificado armazenado no objeto subjacente de DAOParameter
CDaoRecordset::SetParamValueNull	Defina o valor do parâmetro atual especificado como nulo (não ter nenhum valor).
CDaoRecordset::SetPercentPosition	Define a posição do registro atual para um local que corresponde a uma porcentagem do número total de registros em um conjunto de registros.
CDaoRecordset::Update	Termina uma operação de AddNew ou de Editar salvando os novos dados ou editados na fonte de dados.

Membros públicos de dados

Nome	Descrição
CDaoRecordset::m_bCheckCacheForDirtyFields	Contém um sinalizador que indica se campos são marcadas automaticamente como alterados.
CDaoRecordset::m_nFields	Contém o número de membros de dados do campo na classe do conjunto de registros e o número de colunas selecionadas pelo conjunto de registros da fonte de dados.
CDaoRecordset::m_nParams	Contém o número de membros de dados do parâmetro na classe do conjunto de registros — o número de parâmetros passados com a consulta ao conjunto de registros
CDaoRecordset::m_pDAORecordset	Um ponteiro para a interface de DAO que é subjacente ao objeto do conjunto de registros.
CDaoRecordset::m_pDatabase	O banco de dados de origem para este conjunto de resultados. Contém um ponteiro para um objeto de CDaoDatabase .
CDaoRecordset::m_strFilter	Contém uma cadeia de caracteres usada para construir uma instrução SQL WHERE .
CDaoRecordset::m_strSort	Contém uma cadeia de caracteres usada para construir uma instrução SQL ORDENAR POR .

Comentários

Conhecido como “conjuntos de registros,” os objetos de CDaoRecordset estão disponíveis em três formas:

Os conjuntos de registros de tipo representam uma tabela com base que você pode usar para examinar, adicionar, modificar, ou excluir registros de uma única tabela de banco de dados.
Os conjuntos de registros de Dynaset- tipo é o resultado de uma consulta que pode ter registros atualizável. Esses conjuntos de registros são um conjunto de registros que você pode usar para examinar, adicionar, modificar, ou excluir registros de uma tabela de banco de dados ou das tabelas subjacentes. Os conjuntos de registros de Dynaset- tipo podem conter campos de uma ou mais tabelas em um banco de dados.
Os conjuntos de registros de Instantâneo- tipo são uma cópia estática de um conjunto de registros que você pode usar para localizar dados ou gerar relatórios. Esses conjuntos de registros podem conter campos de uma ou mais tabelas em um banco de dados mas não podem ser atualizados.

Cada formulário do recordset representa um conjunto de registros corrigidos no conjunto de registros é aberto. Quando você colocar um registro em um conjunto de registros da tabela ou tipo em um conjunto de registros de dynaset- tipo, reflete as alterações feitas ao registro depois que o conjunto de registros é aberto, por outros usuários ou por outros conjuntos de registros em seu aplicativo. (O conjunto de registros de instantâneo- de tipo não pode ser atualizado.) Você pode usar CDaoRecordset diretamente ou derivar uma classe específica do aplicativo do conjunto de registros de CDaoRecordset. Você pode então:

Scroll através dos registros.
Definir um índice e procura por registros rapidamente usando Pesquisa (conjuntos de registros de tipo com somente).
Localizar registros com base em uma comparação de cadeias de caracteres: "<", "<=", "=", ">=", ou ">" (conjuntos de registros de dynaset- tipo e tipo de instantâneo-).
Atualizar os registros e especificar um modo de bloqueio (exceto conjuntos de registros de instantâneo- tipo).
Filtrar o conjunto de registros para restringir esse os registros ele selecione de esses disponíveis na fonte de dados.
Classificar o conjunto de registros.
Parametrizar o conjunto de registros para personalizar sua seleção com informações não conhecido até o tempo de execução.

As fontes de CDaoRecordset uma interface semelhante a da classe CRecordset. A principal diferença é que os dados dos acessos de CDaoRecordset da classe com um acesso a dados (DAO) objeto com base no OLE. A classe CRecordset acessa o DBMS através de Open Database Connectivity (ODBC) e um driver ODBC para esse DBMS.

Dica

As classes de banco de dados de DAO são distintas de classes do banco de dados MFC baseado em Open Database Connectivity (ODBC).Todos os nomes de classe de banco de dados de DAO têm o prefixo “CDao”.Você ainda pode acessar fontes de dados ODBC com as classes de DAO; as classes de DAO geralmente oferecem recursos superiores como são específicas para o mecanismo de banco de dados Microsoft Jet.

Você pode usar CDaoRecordset diretamente ou derivar uma classe de CDaoRecordset. Para usar em ambos os casos uma classe de conjunto de registros, abra um banco de dados e crie um objeto do conjunto de registros, passando o construtor um ponteiro para seu objeto de CDaoDatabase . Você também pode criar um objeto de CDaoRecordset e permitir que o MFC criar um objeto temporário de CDaoDatabase para você. Chame a função de membro de Abrir do conjunto de registros, especificando se o objeto é um conjunto de registros de tipo, com um conjunto de registros de dynaset- tipo, ou um conjunto de registros de instantâneo- tipo. A chamada Abrir seleciona dados do banco de dados e retorna o primeiro registro.

Use os membros das funções de membro e dados de objeto a rolagem pelos registros e opere-os sobre. As operações disponíveis dependem se o objeto é um conjunto de registros de tipo, com um conjunto de registros de dynaset- tipo, ou um conjunto de registros de instantâneo- tipo, e se é ou atualizável somente leitura — isso depende do recurso de banco de dados ou da fonte de dados ODBC (ODBC). Para atualizar registros que podem ter sido adicionado ou modificados desde que a chamada de Abrir , chama a função de membro de Requery do objeto. Chame a função de membro de Fechar do objeto e destrua o objeto quando você terminar com ele.

Troca do campo do registro do usa DAO deCDaoRecordset (DFX) para oferecer suporte à leitura e atualização de campos do registro através de membros tipo seguro C++ do seu CDaoRecordset ou de CDaoRecordset- classe derivada. Você também pode implementar a associação dinâmica de colunas em um banco de dados sem usar o mecanismo de DFX usando GetFieldValue e SetFieldValue.

Para informações relacionadas, consulte o tópico “object conjunto de registros” na ajuda de DAO.