conjunto de registros: Criando e fechando Recordsets (ODBC)

Este tópico se aplica a classes MFC ODBC.

Para usar um conjunto de registros, construir um objeto recordset e, em seguida, chame seu em aberto função de membro para executar consulta do conjunto de registros e selecionar registros.Quando você terminar com o conjunto de registros, fechar e destruir o objeto.

Este tópico explica:

• Quando e como criar um objeto conjunto de registros.

• Quando e como o comportamento do conjunto de registros pode ser qualificado parametrização, filtragem, classificação ou bloqueando-.

• Quando e como fechar um objeto de conjunto de registros.

Criando conjuntos de registros no time de execução

Antes de criar objetos de conjunto de registros no seu programa, você normalmente gravar classes de conjunto de registros específicos do aplicativo.Para obter mais informações sobre esta etapa preliminar, consulte Adicionando um consumidor ODBC do MFC.

Abra um objeto do tipo dynaset ou instantâneo quando você precisa selecionar registros de uma fonte de dados.O tipo de objeto a ser criado depende do que você precisa fazer com os dados em seu aplicativo e seu driver de ODBC que oferece suporte.Para obter mais informações, consulte Dynaset and instantâneo.

Para em em aberto um conjunto de registros

1. Construir um objeto de seu CRecordset-classe derivada.

   Você pode construir o objeto na pilha ou no registro de ativação de uma função.

2. Opcionalmente, modificar o comportamento de conjunto de registros padrão.Para as opções disponível, consulte configuração Opções de conjunto de registros.

3. telefonar em abertofunção de membro .

No construtor, passar um ponteiro para um CDatabase objeto ou passagem NULO para usar um objeto de banco de dados temporário que a estrutura constrói e abre com base em cadeia de conexão retornada pelo GetDefaultConnectfunção de membro .The CDatabase objeto talvez já esteja conectado a uma fonte de dados.

A telefonar para em aberto usa SQL para selecionar registros da fonte de dados.O primeiro registro selecionado (se houver) é o registro corrente.Os valores dos campos desse registro são armazenados em membros de dados de campo do objeto conjunto de registros.Se todos os registros foram selecionados, a IsBOF e IsEOF funções de membro retornam 0.

No seu em aberto telefonar, você pode:

• Especifique se o conjunto de registros é um tipo dynaset ou instantâneo.em em aberto Recordsets sistema autônomo snapshots por padrão.Ou, você pode especificar um conjunto de encaminhar ou somente registros que permite a rolagem somente encaminhar, um registro por vez.

  Por padrão, um conjunto de registros usa o tipo padrão armazenado no CRecordset membro de dados m_nDefaultType.Assistentes de escrever código para inicializar m_nDefaultType para o tipo de conjunto de registros escolhido no assistente.Em vez de aceitar esse padrão, você pode substituir outro tipo de conjunto de registros.

• Especifique uma seqüência de caracteres para substituir o padrão SQL selecionar demonstrativo que constrói o conjunto de registros.

• Especifique se o conjunto de registros é somente leitura ou somente de acrescentar.Recordsets permitir completos de atualização com o padrão, mas você pode limitar o que a adicionar novos registros somente ou você pode proibir todas as atualizações.

O exemplo a seguir mostra como em em aberto um objeto de instantâneo somente leitura de classe CStudentSet, uma classe específica do aplicativo:

// Construct the snapshot object
CStudentSet rsStudent( NULL );
// Set options if desired, then open the recordset
if(!rsStudent.Open(CRecordset::snapshot, NULL, CRecordset::readOnly))
    return FALSE;
// Use the snapshot to operate on its records...

Depois que você telefonar em aberto, usar os membros de dados e funções de membro do objeto para trabalhar com registros.Em alguns casos, convém repetir a consulta ou atualizar o conjunto de registros para incluir as alterações ocorridas na fonte de dados.Para obter mais informações, consulte conjunto de registros: Repetindo a consulta um conjunto de registros (ODBC).

Dica:
A seqüência de conectar que você usa durante o desenvolvimento talvez não seja a mesma seqüência de conectar eventual seus usuários precisam.Para obter idéias sobre generalizar o seu aplicativo em relação a isso, consulte Fonte de dados: Gerenciando conexões (ODBC).

Definindo opções de conjunto de registros

Após você construir seu objeto de conjunto de registros mas antes de você telefonar em aberto para selecionar registros, convém definir algumas opções para controlar o comportamento do conjunto de registros.Para todos os conjuntos de registros, você pode:

• Especifique um filtro para restringir a seleção de registro.

• Especifique um classificar ordem para os registros.

• Especificar parâmetros para que você possa selecionar registros usando informações obtidas ou calculado em time de execução.

Você também pode conjunto a opção a seguir se condições forem atendidas:

• Se o conjunto de registros é atualizável e oferece suporte a opções de bloqueio, especifique o o bloqueio método usado para atualizar.

Observação:
Para afetar a seleção de registro, você deve conjunto essas opções antes de você telefonar o em abertofunção de membro .

Fechar um conjunto de registros

Quando terminar seu conjunto de registros, você deve utilizadas e desalocar a memória.

Para fechar um conjunto de registros

1. Chamar sua Fecharfunção de membro .

2. Destrua o objeto de conjunto de registros.

   Se você o declarado na estrutura de pilhas de uma função, o objeto é destruído automaticamente quando o objeto fica fora do escopo.Caso contrário, use o Excluir operador.

Fechar libera HSTMT alça.Ele não destrói o objeto C++.

Consulte também

Conceitos

conjunto de registros (ODBC)

conjunto de registros: Rolagem (ODBC)

conjunto de registros: Adicionando, atualizando e excluindo registros (ODBC)