CRecordset::Open
Abre o conjunto de registros recuperando a tabela ou executando a consulta que o conjunto de registros representa.
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.
Dica
Acesso a uma fonte de dados por meio de um objeto de CRecordset sempre é compartilhado.Ao contrário da classe de CDaoRecordset , você não pode usar um objeto de CRecordset para abrir uma fonte de dados com acesso exclusivo.
Quando você chama Abrir, uma consulta, geralmente uma instrução SQL SELECIONAR , selecionar registros com base nos critérios mostrados na tabela a seguir.
Valor do parâmetro de lpszSQL |
Os registros selecionados são determinados por |
Exemplo |
|---|---|---|
NULL |
A cadeia de caracteres retornada por GetDefaultSQL. |
|
Nome de uma tabela SQL |
Todas as colunas da tabela lista em DoFieldExchange ou em DoBulkFieldExchange. |
"Customer" |
Nome predefinido de consulta (procedimento armazenado) |
As colunas a consulta são definidas para retornar. |
"{call OverDueAccts}" |
tabela lista de FROM da lista de colunas deSELECIONAR |
As colunas específicas de tabelas especificadas. |
"SELECT CustId, CustName FROM Customer" |
Aviso
Desconfie que você não insere o espaço em branco adicional na cadeia de caracteres SQL.Por exemplo, se você inserir o espaço em branco entre a chave encaracolado e a palavra-chave de CALL , o MFC interpretará errado a cadeia de caracteres SQL como um nome de tabela e a inserir em uma instrução de SELECIONAR , que resulta em uma exceção que está sendo lançada.Da mesma forma, se sua consulta predefinida usa um parâmetro de saída, não insira o espaço em branco entre a chave encaracolado e “?” símbolo.Finalmente, você não deve inserir o espaço em branco antes de chave encaracolado em uma instrução de CALL ou antes de palavras-chave de SELECIONAR em uma instrução de SELECIONAR .
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
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