Classe CDaoDatabase

Artigo
06/10/2015

Representa uma conexão a um banco de dados através da qual você pode operar nos dados.

class CDaoDatabase : public CObject

Membros

Construtores public

Nome	Descrição
CDaoDatabase::CDaoDatabase	Constrói um objeto de CDaoDatabase . Chame Abrir o objeto para se conectar a um banco de dados.

Métodos públicos

Nome	Descrição
CDaoDatabase::CanTransact	Retorna diferente de zero se as transações de suporte de banco de dados.
CDaoDatabase::CanUpdate	Retorna diferente de zero se o objeto de CDaoDatabase é não atualizável (somente leitura).
CDaoDatabase::Close	Fecha a conexão de banco de dados.
CDaoDatabase::Create	Cria o objeto de banco de dados subjacente de DAO e inicializa o objeto de CDaoDatabase .
CDaoDatabase::CreateRelation	Define um novo relacionamento entre as tabelas no banco de dados.
CDaoDatabase::DeleteQueryDef	Exclui um objeto de querydef salvo na coleção de QueryDefs de banco de dados.
CDaoDatabase::DeleteRelation	Exclui um relacionamento entre tabelas existente no banco de dados.
CDaoDatabase::DeleteTableDef	Exclui a definição de uma tabela no banco de dados. Isso exclui a tabela real e todos os seus dados.
CDaoDatabase::Execute	Executa uma consulta ação. Chamada Executar para uma consulta que retorna os resultados gera uma exceção.
CDaoDatabase::GetConnect	Retorna a cadeia de conexão usada para se conectar o objeto de CDaoDatabase a um banco de dados. Usado para ODBC.
CDaoDatabase::GetName	Retorna o nome do banco de dados atualmente em uso.
CDaoDatabase::GetQueryDefCount	Retorna o número de consultas definidas para o banco de dados.
CDaoDatabase::GetQueryDefInfo	Retorna informações sobre uma consulta específicada definida no banco de dados.
CDaoDatabase::GetQueryTimeout	Retorna o número de segundos após o qual de tempo limite do das operações consulta de banco de dados. Afeta aberto qualquer subseqüente, adicione novo, atualização, e operações de edição e outras operações em fontes de dados ODBC (somente) como chamadas de Executar .
CDaoDatabase::GetRecordsAffected	Retorna o número de registros afetados pela última atualização, editar, ou adicione a operação ou por uma chamada a Executar.
CDaoDatabase::GetRelationCount	Retorna o número de relacionamentos entre tabelas definidas no banco de dados.
CDaoDatabase::GetRelationInfo	Retorna informações sobre uma relação especificada definida entre tabelas no banco de dados.
CDaoDatabase::GetTableDefCount	Retorna o número de tabelas definido no banco de dados.
CDaoDatabase::GetTableDefInfo	Retorna informações sobre uma tabela especificada no banco de dados.
CDaoDatabase::GetVersion	Retorna a versão do mecanismo de banco de dados associado com o banco de dados.
CDaoDatabase::IsOpen	Retorna diferente de zero se o objeto de CDaoDatabase é atualmente conectado a um banco de dados.
CDaoDatabase::Open	Estabelece uma conexão a um banco de dados.
CDaoDatabase::SetQueryTimeout	Define o número de segundos após o qual as operações de consulta de banco de dados (em fontes de dados ODBC somente) tempo limite. Afeta aberto qualquer subseqüente, adicione novo, a atualização, e as operações de exclusão.

Membros públicos de dados

Nome	Descrição
CDaoDatabase::m_pDAODatabase	Um ponteiro para o objeto de banco de dados subjacente de DAO.
CDaoDatabase::m_pWorkspace	Um ponteiro para o objeto de CDaoWorkspace que contém o banco de dados e define o espaço de transação.

Comentários

Para obter mais informações sobre formatos de banco de dados compatíveis, consulte a função de membro de GetName . Você pode ter um ou mais objetos de CDaoDatabase ativos em uma hora em um determinado “espaço de trabalho,” representado por um objeto de CDaoWorkspace . O espaço de trabalho mantém uma coleção de objetos de banco de dados abertos, chamada a coleção de bancos de dados.

Dica

As classes de banco de dados MFC DAO são distintas de classes do banco de dados MFC baseado em ODBC.Todos os nomes de classe de banco de dados de DAO têm o prefixo “CDao”.A classe CDaoDatabase fornece uma interface semelhante a da classe CDatabaseODBC.A principal diferença é que CDatabase acessa o DBMS através de Open Database Connectivity (ODBC) e um driver ODBC para esse DBMS.Dados dos acessos deCDaoDatabase através de um objeto (DAO) de acesso a dados com base no mecanismo de banco de dados Microsoft Jet.Em geral, as classes MFC com base em DAO mais são capazes das classes MFC baseado em ODBC; as classes base DAO- podem acessar os dados, incluindo através dos drivers ODBC, através de seu próprio mecanismo de banco de dados.As classes base DAO- também suporta operações language (DDL) de definição de dados, como adicionar tabelas por meio de classes, sem precisar chamar diretamente DAO.

Uso

Você pode criar objetos de banco de dados, implicitamente quando você cria objetos do conjunto de registros. Mas você também pode criar objetos de banco de dados explicitamente. Para usar explicitamente um banco de dados existente com CDaoDatabase, faça qualquer um dos seguintes:

Construir um objeto de CDaoDatabase , passando um ponteiro para um objeto de abertura de CDaoWorkspace .
Ou construir um objeto de CDaoDatabase sem especificar o espaço de trabalho (o MFC cria um objeto temporário de espaço de trabalho).

Para criar um novo banco de dados do Microsoft Jet (.MDB), construir um objeto de CDaoDatabase e chamar a função de membro de Criar . Não chamar Abrir após Criar.

Para abrir um banco de dados existente, construir um objeto de CDaoDatabase e chamar a função de membro de Abrir .

Qualquer uma de essas técnicas acrescentam o objeto de banco de dados de DAO a bancos de dados coleção de espaço de trabalho e abrir uma conexão a dados. Quando você constrói em objetos de CDaoRecordset, de CDaoTableDef, ou de CDaoQueryDef para operar no banco de dados de rede, passar os construtores para esses objetos um ponteiro para seu objeto de CDaoDatabase . Quando você terminar usar a conexão, chame a função de membro de Fechar e destrua o objeto de CDaoDatabase . Fechar fecha todos os conjuntos de registros que não se você fechar anteriormente.

Transações

O processamento de transações de banco de dados é fornecido no nível de espaço de trabalho — consulte as funções de membro de BeginTrans, de CommitTrans, e de Rollback da classe CDaoWorkspace.

Conexões ODBC

A maneira recomendada para trabalhar com fontes de dados ODBC é anexar externos tabelas em um banco de dados Microsoft Jet (.MDB).

Coleções

Cada banco de dados mantém suas próprias coleções de tabledef, de querydef, o conjunto de registros, e objetos de relacionamento. A classe CDaoDatabase fornece funções de membro para manipular esses objetos.

Dica

Os objetos são armazenados em DAO, não no objeto de banco de dados MFC.O MFC fornece classes para o tabledef, o querydef, e objetos do recordset mas não para objetos de relacionamento.