CRecordset::Open

Publicado: abril de 2016

Abre o conjunto de registros recuperando a tabela ou executando a consulta que o conjunto de registros representa.

Sintaxe

      virtual BOOL Open( 
   UINT nOpenType = AFX_DB_USE_DEFAULT_TYPE, 
   LPCTSTR lpszSQL = NULL, 
   DWORD dwOptions = none  
);

Parâmetros

• nOpenType
  Aceite o valor padrão, AFX_DB_USE_DEFAULT_TYPE, ou use um dos seguintes valores de enum OpenType:

  • Conjunto de registros de ACRecordset::dynasetcom rolagem bidirecional.  A associação e ordenação de registros são determinadas quando o conjunto de registros é aberto, mas as alterações feitas por outros usuários para valores de dados são visíveis seguindo uma operação de esforço.  Dynasets é também conhecido como conjuntos de registros conjunto de teclas- dinâmicos.  

  • Conjunto de registros estático deCRecordset::snapshotcom A rolagem bidirecional.  A associação e ordenação de registros são determinadas quando o conjunto de registros é aberto; os valores de dados são determinados quando registros são buscados.  As alterações feitas por outros usuários não são visíveis até que o conjunto de registros é fechado e reaberto em seguida.  

  • Conjunto de registros de ACRecordset::dynamiccom rolagem bidirecional.  As alterações feitas por outros usuários da associação, a ordenação, e valores de dados são visíveis seguindo uma operação de esforço.  Observe que muitos drivers ODBC não suportam este tipo de conjunto de registros.  

  • Conjunto de registros somente leitura de ACRecordset::forwardOnlycom apenas rolagem frente.

    Para CRecordset, o valor padrão é CRecordset::snapshot.  O mecanismo de valor padrão permite que os assistentes do Visual C++ interagir com ODBC CRecordset e os DAO CDaoRecordset, que possuem opções diferentes.  

  Para obter mais informações sobre esses tipos de conjunto de registros, consulte o artigo Conjunto de registros (ODBC).  Para informações relacionadas, consulte o artigo “usar o bloco e cursores roláveis” em Windows SDK.  

  Aviso

  Se o tipo solicitado não é suportado, a estrutura gerencie uma exceção.

• lpszSQL
  Um ponteiro de cadeia de caracteres que contém um destes procedimentos:

  • Um ponteiro de NULO .

  • O nome de uma tabela.

  • Uma instrução SQL SELECIONAR (opcionalmente com um SQL WHERE ou cláusula de ORDENAR POR ).

  • Uma declaração de CALL que especifica o nome de uma consulta predefinida (procedimento armazenado).  Desconfie que você não insere o espaço em branco entre a chave encaracolado e a palavra-chave de CALL .  

  Para obter mais informações sobre essa cadeia de caracteres, consulte a tabela e exame de função de ClassWizard em comentários.

  Dica

  A ordem das colunas em seu conjunto de resultados deve coincidir com a ordem de RFX ou chamadas de função em massa de RFX em sua sobrescrita de função de DoFieldExchange ou de DoBulkFieldExchange .

• dwOptions
  Uma máscara de bits que pode especificar uma combinação de valores listados abaixo.  Algumas delass é mutuamente exclusivos.  O valor padrão é none.  

  • CRecordset::none as opções definidas.  Este valor do parâmetro é mutuamente exclusiva com todos os outros valores.  Por padrão, o recordset pode ser atualizado com Edição ou Exclua e reserva anexar novos registros com AddNew.  Updatability depende da fonte de dados bem como a opção de nOpenType você especificar.  Otimização para adições em massa não está disponível.  Buscar em massa de linha não será implementado.  Os registros excluídos não serão ignorados durante a navegação do conjunto de registros.  Indexadores não estão disponíveis.  Verifique sujo automático do campo é implementado.  

  • CRecordset::appendOnly não permite Editar ou Excluir no conjunto de registros.  Permite AddNew somente.  Essa opção é mutuamente exclusiva com CRecordset::readOnly.  

  • CRecordset::readOnly Abrir o conjunto de registros como somente leitura.  Essa opção é mutuamente exclusiva com CRecordset::appendOnly.  

  • Uso deCRecordset::optimizeBulkAdduma instrução SQL preparada otimizar adicione vários registros ao mesmo tempo.  Se aplica somente se você não estiver usando a função SQLSetPos de API ODBC para atualizar o conjunto de registros.  A primeira atualização determina quais campos estão impróprios marcado.  Essa opção é mutuamente exclusiva com CRecordset::useMultiRowFetch.  

  • linha de volume de fornecedores deCRecordset::useMultiRowFetchque pesquisa para permitir que várias linhas sejam recuperadas em uma única operação de esforço.  Este é um recurso avançado criado para melhorar o desempenho; no entanto, a troca de campo do registro de volume não é suportada por ClassWizard.  Essa opção é mutuamente exclusiva com CRecordset::optimizeBulkAdd.  Observe que se você especificar CRecordset::useMultiRowFetch, então a opção CRecordset::noDirtyFieldCheck será ativada automaticamente (proteção duplas não estará disponível); em conjuntos de registros somente encaminhamentos, a opção CRecordset::useExtendedFetch será automaticamente ativada.  Para obter mais informações sobre a linha em massa que pesquisa, consulte o artigo Conjunto de registros: Buscando registros em massa (ODBC).  

  • Skip deCRecordset::skipDeletedRecordstodos os registros excluídos para navegar pelo conjunto de registros.  Isso retardará o desempenho em determinados esforços relacionados.  Esta opção não é válido em conjuntos de registros somente encaminhamentos.  Se você chamar Mova com o parâmetro de nRows definido como 0, e a opção definida de CRecordset::skipDeletedRecords , Mover afirmará.  Observe que CRecordset::skipDeletedRecords é semelhante à caixa de driver, o que significa que linhas excluídas são removidas de conjunto de registros.  No entanto, se o driver empacotamento registros, então ele ignorará somente os registros que você exclui; não ignorará os registros excluídos por outros usuários quando o conjunto de registros é aberto.  CRecordset::skipDeletedRecords ignorará linhas excluídas por outros usuários.  

  • O uso deCRecordset::useBookmarksmaio marca um endereço da Internet no conjunto de registros, se suportado.  A recuperação de dados lento de indexadores mas melhora o desempenho para navegação de dados.  Válido em conjuntos de registros somente encaminhamentos.  Para obter mais informações, consulte o artigo Conjunto de registros: Indexadores e posições absolutas (ODBC).  

  • CRecordset::noDirtyFieldCheck desativa verificação sujo automático do campo (proteção dupla).  Isso irá melhorar o desempenho; entretanto, você deve manualmente marcar como campos impróprios chamando as funções de membro de SetFieldDirty e de SetFieldNull . Observe que a proteção duas vezes na classe CRecordset é semelhante à proteção duas vezes na classe CDaoRecordset.  No entanto, em CRecordset, você não pode ativar a proteção duas vezes em campos individuais; você habilita para todos os campos ou desativá-lo para todos os campos.  Observe que se você especificar a opção CRecordset::useMultiRowFetch, então CRecordset::noDirtyFieldCheck será ativado automaticamente; no entanto, SetFieldDirty e SetFieldNull não podem ser usados em conjuntos de registros que implementam buscar em massa da linha.  

  • CRecordset::executeDirect não usa uma instrução SQL preparada.  Para melhor desempenho, especificar esta opção se a função de membro de RepetirConsulta será chamada nunca.  

  • Implemente  SQLExtendedFetch deCRecordset::useExtendedFetchem vez de SQLFetch.  Isso é criado implementando-se a linha em massa que pesquisa em conjuntos de registros somente encaminhamentos.  Se você especificar a opção CRecordset::useMultiRowFetch em um conjunto de registros somente encaminhamento, então CRecordset::useExtendedFetch será ativado automaticamente.  

  • CRecordset::userAllocMultiRowBuffers o usuário atribuirá buffers de armazenamento de dados.  Use esta opção em conjunto com CRecordset::useMultiRowFetch se você deseja atribuir seu próprio armazenamento; caso contrário, a estrutura atribuirá automaticamente o armazenamento necessário.  Para obter mais informações, consulte o artigo Conjunto de registros: Buscando registros em massa (ODBC).  Observe que especifica CRecordset::userAllocMultiRowBuffers sem especificar CRecordset::useMultiRowFetch resultará em uma declaração falha.  

Valor de retorno

Diferente de zero se o objeto de CRecordset foi aberto com êxito; se não 0 se retorna 0 de CDatabase::Open (se chamado).

Comentários

Você deve chamar essa função de membro para executar a consulta definida pelo conjunto de registros.  Antes de chamar Abrir, você deve criar o objeto do conjunto de registros.  

A conexão desse conjunto de registros à fonte de dados depende de como você constrói o conjunto de registros antes de chamar Abrir.  Se você passar um objeto de CDatabase para o construtor do conjunto de registros que não foi conectado à fonte de dados, usa GetDefaultConnect dessa função de membro tentar abrir o objeto de base de dados.  Se você passar NULO para o construtor do conjunto de registros, o construtor constrói um objeto de CDatabase para você, e tentativas de Abrir conectar o objeto de base de dados.  Para obter detalhes sobre feche o conjunto de registros e a conexão nessas condições de variação, consulte Final.  

Quando você chama Abrir, uma consulta, geralmente uma instrução SQL SELECIONAR , selecionar registros com base nos critérios mostrados na tabela a seguir.

O procedimento usual é passar NULO a Abrir; nesse caso, chamadas GetDefaultSQLde Abrir .  Se você estiver usando uma classe derivada de CRecordset , GetDefaultSQL fornece os nomes de tabela que você especificou em ClassWizard.  Você pode especificar em vez de outras informações no parâmetro de lpszSQL .  

Tudo o que você passa, compilações de Abrir uma cadeia de caracteres final SQL para a consulta (a cadeia de caracteres pode ter SQL WHERE e as cláusulas de ORDENAR POR adcionadas a lpszSQL amarram-no passaram) e executar a consulta.  Você pode analisar a cadeia de caracteres construída chamando GetSQL após chamado Abrir.  Para obter detalhes adicionais sobre como o conjunto de registros constrói uma instrução SQL e selecionar registros, consulte o artigo Conjunto de registros: Como os conjuntos de registros selecione registros (ODBC).  

Membros de dados do campo de sua classe do conjunto de registros são associados às colunas de dados selecionadas.  Se qualquer registro é retornado, o primeiro registro torna-se o registro atual.  

Se você desejar definir opções para o conjunto de registros, como um filtro ou um tipo, especifique esses depois que você constrói o objeto do conjunto de registros mas antes de chamar Abrir.  Se você deseja atualizar registros no conjunto de registros após o conjunto de registros já está aberto, chame Requery.  

Para obter mais informações, incluindo exemplos adicionais, consulte os artigos Conjunto de registros (ODBC), Conjunto de registros: Como os conjuntos de registros selecione registros (ODBC), e Conjunto de registros: Criando e fechando conjuntos de registros (ODBC).

Exceções

Exception

Condition

Esse método pode lançar exceções do tipo CDBException* e CMemoryException*.

Exemplo

Os formulários diferentes dos exemplos a seguir mostram de código de chamada de Abrir .

// rsSnap, rsLName, and rsDefault are CRecordset or CRecordset-derived 
// objects

// Open rs using the default SQL statement, implement bookmarks, and turn 
// off automatic dirty field checking
rsSnap.Open(CRecordset::snapshot, NULL, CRecordset::useBookmarks | 
   CRecordset::noDirtyFieldCheck);

// Pass a complete SELECT statement and open as a dynaset
rsLName.Open(CRecordset::dynaset, _T("Select L_Name from Customer"));

// Accept all defaults
rsDefault.Open();

Requisitos

Cabeçalho: afxdb.h

Consulte também

Classe de CRecordset
Gráfico da hierarquia
CRecordset::CRecordset
CRecordset::Close
CRecordset::GetDefaultSQL
CRecordset::GetSQL
CRecordset::m_strFilter
CRecordset::m_strSort
CRecordset::Requery