Classe CRecordset

Artigo
06/10/2015

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

class CRecordset : public CObject

Membros

Construtores public

Nome	Descrição
CRecordset::CRecordset	Constrói um objeto de CRecordset . Sua classe derivada deve fornecer um construtor que chama esse.

Métodos públicos

Nome	Descrição
CRecordset::AddNew	Prepara-se adicionando um novo registro. Chamada Update para concluir a adição.
CRecordset::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 .
CRecordset::CanBookmark	Retorna diferente de zero se o recordset suporta indicadores.
CRecordset::Cancel	Cancela uma operação assíncrona ou processo de um segundo segmento.
CRecordset::CancelUpdate	Cancela todas as atualizações pendentes devido a uma operação de AddNew ou de Edit .
CRecordset::CanRestart	Retorna diferente de zero se Requery pode ser chamado para executar novamente a consulta ao conjunto de registros.
CRecordset::CanScroll	Retorna diferente de zero se você pode percorrer os registros.
CRecordset::CanTransact	Retorna diferente de zero se a fonte de dados suportar transações.
CRecordset::CanUpdate	Retorna diferente de zero se o recordset pode ser atualizado (você pode adicionar, atualizar ou excluir registros,).
CRecordset::CheckRowsetError	Chamado para manipular erros gerados durante a busca do registro.
CRecordset::Close	Fecha o conjunto de registros e o ODBC HSTMT associado a ele.
CRecordset::Delete	Exclui o registro atual do conjunto de registros. Você deve explicitamente rolar outro registro após a exclusão.
CRecordset::DoBulkFieldExchange	Chamado para trocar linhas em massa de dados da fonte de dados ao conjunto de registros. Troca do campo do registro de volume implements (RFX em massa.)
CRecordset::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 implements (RFX).
CRecordset::Edit	Para prepara-se alterações para o registro atual. Chamada Update para concluir a edição.
CRecordset::FlushResultSet	Retorna diferente de zero se há outro conjunto de resultados a ser recuperado, ao usar uma consulta pré-definida.
CRecordset::GetBookmark	Atribui o valor do indexador de um registro para o objeto de parâmetro.
CRecordset::GetDefaultConnect	Chamado para obter a cadeia de conexão padrão.
CRecordset::GetDefaultSQL	Chamado para obter a cadeia de caracteres SQL padrão para executar.
CRecordset::GetFieldValue	Retorna o valor de um campo em um conjunto de registros.
CRecordset::GetODBCFieldCount	Retorna o número de campos no conjunto de registros.
CRecordset::GetODBCFieldInfo	Retorna tipos específicos de informações sobre os campos em um conjunto de registros.
CRecordset::GetRecordCount	Retorna o número de registros no conjunto de registros.
CRecordset::GetRowsetSize	Retorna o número de registros que você deseja recuperar durante um único esforço.
CRecordset::GetRowsFetched	Retorna o número de linhas real recuperadas em um esforço.
CRecordset::GetRowStatus	Retorna o status da linha após um esforço.
CRecordset::GetSQL	Obtém a cadeia de caracteres SQL usada para selecionar registros para o conjunto de registros.
CRecordset::GetStatus	Obtém o status do conjunto de registros: o índice do registro atual e se uma contagem final dos registros foi obtida.
CRecordset::GetTableName	Obtém o nome da tabela no conjunto de registros é baseado.
CRecordset::IsBOF	Retorna diferente de zero se o conjunto de registros está posicionado antes do primeiro registro. Não há nenhum registro atual.
CRecordset::IsDeleted	Retorna diferente de zero se o conjunto de registros é posicionado em um registro excluído.
CRecordset::IsEOF	Retorna diferente de zero se o recordset foi posicionado após o último registro. Não há nenhum registro atual.
CRecordset::IsFieldDirty	Retorna diferente de zero se o campo especificado no registro atual foi alterado.
CRecordset::IsFieldNull	Retorna diferente de zero se o campo especificado no registro atual é zero (não tem nenhum valor).
CRecordset::IsFieldNullable	Retorna diferente de zero se o campo especificado no registro atual pode ser definido como nulo (não ter nenhum valor).
CRecordset::IsOpen	Retorna diferente de zero se Open tiver sido chamado anteriormente.
CRecordset::Move	Posiciona o conjunto de registros a um número de registros especificado do registro atual em ambas as direções.
CRecordset::MoveFirst	Posiciona o registro atual no primeiro registro no conjunto de registros. Teste para IsBOF primeiro.
CRecordset::MoveLast	Posiciona o registro atual no último registro ou no rowset o último. Teste para IsEOF primeiro.
CRecordset::MoveNext	Posiciona o registro atual no próximo registro ou no rowset seguir. Teste para IsEOF primeiro.
CRecordset::MovePrev	Posiciona o registro atual no registro anterior ou o rowset anterior. Teste para IsBOF primeiro.
CRecordset::OnSetOptions	Chamado para definir as opções (usadas na seleção) para a instrução especificada ODBC.
CRecordset::OnSetUpdateOptions	Chamado para definir as opções (usadas na atualização) para a instrução especificada ODBC.
CRecordset::Open	Abre o conjunto de registros recuperando a tabela ou executar a consulta que o recordset representa.
CRecordset::RefreshRowset	Atualiza os dados e o status de fileiras especificadas.
CRecordset::Requery	Executa a consulta ao conjunto de registros novamente para atualizar os registros selecionados.
CRecordset::SetAbsolutePosition	Posiciona o conjunto de registros no registro que corresponde ao número de registro especificado.
CRecordset::SetBookmark	Posiciona o conjunto de registros no registro especificado pelo indexador.
CRecordset::SetFieldDirty	Marca o campo especificado no registro atual como modificado.
CRecordset::SetFieldNull	Define o valor do campo especificado no registro atual como nulo (não ter nenhum valor).
CRecordset::SetLockingMode	Define bloquear “optimista” do modo de bloqueio (o padrão) ou pessimista bloqueio “”. Determina como os registros são bloqueados para atualizações.
CRecordset::SetParamNull	Defina o parâmetro especificado como nulo (não ter nenhum valor).
CRecordset::SetRowsetCursorPosition	Posicionar o cursor na linha especificada no rowset.
CRecordset::SetRowsetSize	Especifica o número de registros que você deseja recuperar durante um esforço.
CRecordset::Update	Termina uma operação de AddNew ou de Edit salvando os novos dados ou editados na fonte de dados.

Membros públicos de dados

Nome	Descrição
CRecordset::m_hstmt	Contém o identificador de declaração ODBC para o conjunto de registros. Tipo HSTMT.
CRecordset::m_nFields	Contém o número de membros de dados do campo no conjunto de registros. Tipo UINT.
CRecordset::m_nParams	Contém o número de membros de dados do parâmetro no conjunto de registros. Tipo UINT.
CRecordset::m_pDatabase	Contém um ponteiro para o objeto de CDatabase através do qual o conjunto de registros é conectado a uma fonte de dados.
CRecordset::m_strFilter	Contém CString que especifica uma cláusula estruturada de (SQL) WHERE de linguagem de consulta. Usado como um filtro para selecionar apenas os registros que conhecem certos critérios.
CRecordset::m_strSort	Contém CString que especifica uma cláusula SQL ORDER BY . Usado para controlar como os registros classificados.

Comentários

Conhecido como “conjuntos de registros,” os objetos de CRecordset normalmente são usados em duas formas: dynasets e instantâneos. Um dynaset permanece sincronizado com as atualizações de dados feitas por outros usuários. Um instantâneo é uma exibição estática de dados. Cada formulário representa um conjunto de registros corrigidos no conjunto de registros é aberto, mas quando você colocar um registro em um dynaset, refletir as alterações feitas posteriormente para o registro, por outros usuários ou por outros conjuntos de registros em seu aplicativo.

Dica

Se você estiver trabalhando com acesso a dados objetos de classes (DAO) em vez das classes Open Database Connectivity (ODBC), use a classe CDaoRecordset em vez de isso.Para obter mais informações, consulte o artigo visão geral: Programação do banco de dados.

Para trabalhar com qualquer um amável do conjunto de registros, você normalmente derivado de uma classe específica do aplicativo do conjunto de registros de CRecordset. Os conjuntos de registros selecionar registros de uma fonte de dados, e você pode então:

Scroll através dos registros.
Atualizar os registros e especificar um modo de bloqueio.
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.

Para usar a classe, abra um banco de dados e crie um objeto do conjunto de registros, passando o construtor um ponteiro para seu objeto de CDatabase . Chame a função de membro de Abrir do conjunto de registros, onde você pode especificar se o objeto é um dynaset ou um instantâneo. A chamada Abrir seleciona dados da fonte de dados. Depois que o objeto do conjunto de registros é aberto, use os membros das funções de membro e dados para percorrer os registros e para operá-los sobre. As operações disponíveis dependem se o objeto é um dynaset ou um instantâneo, se é ou atualizável somente leitura (isso depende de recurso de fonte de dados Open Database Connectivity (ODBC)), e se você tiver implementado buscar em massa da linha. 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.

Em uma classe derivada de CRecordset , a troca do campo do registro (RFX) ou a troca em massa do campo do registro (RFX em massa) são usadas para oferecer suporte à leitura e atualização de campos do registro.

Para obter mais informações sobre conjuntos de registros e de troca do campo do registro, consulte os artigos visão geral: Programação do banco de dados, Recordset (ODBC), conjunto de registros: Para buscar registros em massa (ODBC), e Campo do registro Exchange (RFX). Para um foco em dynasets e em instantâneos, consulte os artigos Dynaset e instantâneo.