Classe incorporadas

Artigo
06/10/2015

Representa uma conexão a uma fonte de dados, com o qual você pode operar na fonte de dados.

class CDatabase : public CObject

Membros

Construtores public

Nome	Descrição
CDatabase::CDatabase	Constrói um objeto de CDatabase . Você deve inicializar o objeto chamando OpenEx ou Abrir.

Métodos públicos

Nome	Descrição
CDatabase::BeginTrans	Inicia uma transação “” — uma série de chamadas reversíveis a AddNew, a Editar, a Excluir, e funções de membro de Atualizar da classe CRecordset — na fonte de dados conectados. A fonte de dados deve suportar transações para que BeginTrans tem qualquer efeito.
CDatabase::BindParameters	Permite que você posicione os parâmetros de associadas antes de chamar CDatabase::ExecuteSQL.
CDatabase::Cancel	Cancela uma operação assíncrona ou processo de um segundo segmento.
CDatabase::CanTransact	Retorna diferente de zero se a fonte de dados suportar transações.
CDatabase::CanUpdate	Retorna diferente de zero se o objeto de CDatabase é não atualizável (somente leitura).
CDatabase::Close	Fecha a conexão da fonte de dados.
CDatabase::CommitTrans	Termina uma transação iniciada por BeginTrans. Os comandos na transação que modificam a fonte de dados é realizado.
CDatabase::	Executa uma instrução SQL. Nenhum registro de dados é retornado.
CDatabase::GetBookmarkPersistence	Identifica as operações com que os indicadores persistem em objetos do conjunto de registros.
CDatabase::GetConnect	Retorna a cadeia de conexão ODBC usada para conectar o objeto de CDatabase a uma fonte de dados.
CDatabase::GetCursorCommitBehavior	Identifica o efeito de enviar uma transação em um objeto de abertura do conjunto de registros.
CDatabase::GetCursorRollbackBehavior	Identifica o efeito de reverter uma transação em um objeto de abertura do conjunto de registros.
CDatabase::GetDatabaseName	Retorna o nome do banco de dados atualmente em uso.
CDatabase::IsOpen	Retorna diferente de zero se o objeto de CDatabase é atualmente conectado a uma fonte de dados.
CDatabase::OnSetOptions	Chamado pela estrutura para definir opções de conexão padrão. A implementação padrão define o valor de tempo limite de consulta. Você pode estabelecer essas opções antemão chamando SetQueryTimeout.
CDatabase::Open	Estabelece uma conexão a uma fonte de dados (por meio de um driver ODBC).
CDatabase::OpenEx	Estabelece uma conexão a uma fonte de dados (por meio de um driver ODBC).
CDatabase::Rollback	Inverte de alterações feitas durante a transação atual. A fonte de dados retorna ao seu estado anterior, conforme definido na chamada de BeginTrans , inalterado.
CDatabase::SetLoginTimeout	Define o número de segundos após o qual de um tempo limite do da tentativa de conexão da fonte de dados.
CDatabase::SetQueryTimeout	Define o número de segundos após o qual de tempo limite do das operações consulta de banco de dados. Afeta todo o conjunto de registros subseqüentes Abrir, AddNew, Editar, e chamadas de Excluir .

Membros públicos de dados

Nome	Descrição
CDatabase::m_hdbc	Identificador de conexão Open Database Connectivity (ODBC) para uma fonte de dados. Tipo HDBC.

Comentários

Uma fonte de dados é uma instância específica de dados hospedados por qualquer sistema de gerenciamento de banco de dados (DBMS). Os exemplos incluem o dBASE Microsoft SQL Server, Microsoft Access, de Borland, e o xBASE. Você pode ter um ou mais objetos de CDatabase ativos em vez de no 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 CDaoDatabase em vez de isso.Para obter mais informações, consulte o artigo visão geral: Programação do banco de dados.

Para usar CDatabase, construir um objeto de CDatabase e chamar a função de membro de OpenEx . Isso abre uma conexão. Quando você constrói em objetos de CRecordset para operar na fonte de dados conectado, passe o construtor do recordset um ponteiro para seu objeto de CDatabase . Quando você terminar usar a conexão, chame a função de membro de Fechar e destrua o objeto de CDatabase . Fechar fecha todos os conjuntos de registros que não se você fechar anteriormente.

Para obter mais informações sobre CDatabase, consulte os artigos A fonte de dados (ODBC) e visão geral: Programação do banco de dados.