Classe CDaoDatabase

Representa uma ligação a uma base de dados Access usando Objetos de Acesso a Dados (DAO).

Sintaxe

class CDaoDatabase : public CObject

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

Para informações sobre os formatos de base de dados suportados, consulte a função membro GetName . Pode ter um ou mais CDaoDatabase objetos ativos de cada vez num dado "espaço de trabalho", representados por um objeto CDaoWorkspace . O espaço de trabalho mantém uma coleção de objetos abertos da base de dados, chamada coleção Bases de Dados.

Usage

Podes criar objetos de base de dados implicitamente, quando crias objetos de recordet. Mas também podes criar objetos de base de dados explicitamente. Para usar uma base de dados existente explicitamente com CDaoDatabase, faça qualquer uma das seguintes opções:

• Constrói um CDaoDatabase objeto, passando um ponteiro para um objeto aberto do CDaoWorkspace .

• Ou construir um CDaoDatabase objeto sem especificar o espaço de trabalho (o MFC cria um objeto de espaço de trabalho temporário).

Para criar um novo Microsoft Jet (. MDB), construir um CDaoDatabase objeto e chamar a sua função Create member. Não ligueOpen depois Createde .

Para abrir uma base de dados existente, constrói um CDaoDatabase objeto e chama a sua função membro Open .

Qualquer uma destas técnicas adiciona o objeto da base de dados DAO à coleção de Bases de Dados do espaço de trabalho e abre uma ligação aos dados. Quando construir objetos CDaoRecordset, CDaoTableDef ou CDaoQueryDef para operar na base de dados conectada, passe aos construtores desses objetos um ponteiro para o seu CDaoDatabase objeto. Quando terminares de usar a ligação, chama a função Fechar membro e destrói o CDaoDatabase objeto. Close Fecha quaisquer conjuntos de registos que ainda não tenha fechado.

Transações

O processamento de transações em bases de dados é fornecido ao nível do espaço de trabalho — veja as funções membros BeginTrans, CommitTrans e Rollback da classe CDaoWorkspace.

Conexões ODBC

A forma recomendada de trabalhar com fontes de dados Open Database Base Connectivity (ODBC) é anexar tabelas externas a uma base de dados Microsoft Jet (.MDB).

Collections

Cada base de dados mantém as suas próprias coleções de objetos tabledef, querydef, recordet e relation. A classe CDaoDatabase fornece funções aos membros para manipular estes objetos.

Hierarquia de herança

CObject

CDaoDatabase

Requerimentos

Cabeçalho: afxdao.h

CDaoDatabase::CanTransact

Chame esta função membro para determinar se a base de dados permite transações.

BOOL CanTransact();

Valor de retorno

Diferente de zero se a base de dados suportar transações; caso contrário, 0.

Observações

As transações são geridas no espaço de trabalho da base de dados.

CDaoDatabase::PodeAtualizar

Chame esta função membro para determinar se o CDaoDatabase objeto permite atualizações.

BOOL CanUpdate();

Valor de retorno

Diferente de zero se o CDaoDatabase objeto permitir atualizações; caso contrário 0, indicando ou que passou TRUE em bReadOnly quando abriu o CDaoDatabase objeto ou que a própria base de dados é só de leitura. Veja a função de membro aberto .

Observações

Para informações sobre atualização da base de dados, consulte o tópico "Propriedade Atualizável" na Ajuda do DAO.

CDaoDatabase::CDaoDatabase

Constrói um CDaoDatabase objeto.

CDaoDatabase(CDaoWorkspace* pWorkspace = NULL);

Parâmetros

pWorkspace
Um apontador para o CDaoWorkspace objeto que irá conter o novo objeto da base de dados. Se aceitar o valor padrão de NULL, o construtor cria um objeto temporário CDaoWorkspace que utiliza o espaço de trabalho padrão do DAO. Podes obter um ponteiro para o objeto workspace através do m_pWorkspace membro de dados.

Observações

Depois de construir o objeto, se estiver a criar um novo Microsoft Jet (. MDB), chamar a função Create member do objeto. Se estiver, em vez disso, a abrir uma base de dados existente, chame a função membro Open do objeto.

Quando terminares com o objeto, deves chamar a função do membro Close e depois destruir o CDaoDatabase objeto.

Pode achar conveniente incorporar o CDaoDatabase objeto na sua classe de documentos.

CDaoDatabase::Fechar

Chame esta função membro para se desligar de uma base de dados e encerrar quaisquer registos abertos, defs de tabela e defs de consulta associados à base de dados.

virtual void Close();

Observações

É boa prática fechar estes objetos você mesmo antes de chamar a isto função elemental. Fechar um CDaoDatabase objeto remove-o da coleção Bases de Dados no espaço de trabalho associado. Como Close não destrói o CDaoDatabase objeto, podes reutilizar o objeto abrindo a mesma base de dados ou outra base de dados diferente.

Se o objeto da base de dados estiver definido fora do âmbito de uma função, e sair da função sem a fechar, o objeto da base de dados permanecerá aberto até ser explicitamente fechado ou até o módulo em que está definido estar fora do âmbito.

CDaoDatabase::Create

Para criar um novo Microsoft Jet (. MDB), chama esta função membro depois de construir um CDaoDatabase objeto.

virtual void Create(
    LPCTSTR lpszName,
    LPCTSTR lpszLocale = dbLangGeneral,
    int dwOptions = 0);

Parâmetros

lpszName
Uma expressão string que é o nome do ficheiro da base de dados que está a criar. Pode ser o caminho completo e o nome do ficheiro, como "C:\\MYDB. MDB". Tens de fornecer um nome. Se não fornecer uma extensão de nome de ficheiro, . MDB está anexado. Se a sua rede suportar a convenção uniforme de nomes (UNC), pode também especificar um caminho de rede, como "\\\\MYSERVER\\MYSHARE\\MYDIR\\MYDB". Apenas a Microsoft Jet (. MDB) podem ser criados usando esta função membro. (Barras duplas são obrigatórias nos literais de string porque "\" é o carácter de escape C++.)

lpszLocale
Uma expressão string usada para especificar a ordem de colagem para a criação da base de dados. O valor predefinido é dbLangGeneral. Os valores possíveis são:

• dbLangGeneral Inglês, Alemão, Francês, Português, Italiano e Espanhol Moderno

• dbLangArabic Árabe

• dbLangCyrillic Russo

• dbLangCzech Checo

• dbLangDutch Holandês

• dbLangGreek Grego

• dbLangHebrew Hebraico

• dbLangHungarian Húngaro

• dbLangIcelandic Islandês

• dbLangNordic Línguas nórdicas (apenas versão 1.0 do motor de base de dados Microsoft Jet)

• dbLangNorwdan Norueguesa e dinamarquesa

• dbLangPolish Polaco

• dbLangSpanish Espanhol tradicional

• dbLangSwedfin Sueco e finlandês

• dbLangTurkish Turco

dwOptions
Um inteiro que indica uma ou mais opções. Os valores possíveis são:

• dbEncrypt Crie uma base de dados encriptada.

• dbVersion10 Crie uma base de dados com a versão 1.0 da base de dados Microsoft Jet.

• dbVersion11 Crie uma base de dados com a versão 1.1 da base de dados Microsoft Jet.

• dbVersion20 Crie uma base de dados com a versão 2.0 da base de dados Microsoft Jet.

• dbVersion30 Crie uma base de dados com a versão 3.0 da base de dados Microsoft Jet.

Se omitir a constante de encriptação, cria-se uma base de dados não encriptada. Só pode especificar uma constante de versão. Se omitir uma constante de versão, é criada uma base de dados que utiliza a base de dados Microsoft Jet versão 3.0.

Observações

Create cria o ficheiro da base de dados e o objeto de base de dados DAO subjacente e inicializa o objeto C++. O objeto é adicionado à coleção de Bases de Dados do espaço de trabalho associado. O objeto da base de dados está em estado aberto; Não ligues Open* depois Createde .

CDaoDatabase::CreateRelation

Chame esta função membro para estabelecer uma relação entre um ou mais campos numa tabela primária da base de dados e um ou mais campos numa tabela estrangeira (outra tabela na base de dados).

void CreateRelation(
    LPCTSTR lpszName,
    LPCTSTR lpszTable,
    LPCTSTR lpszForeignTable,
    long lAttributes,
    LPCTSTR lpszField,
    LPCTSTR lpszForeignField);

void CreateRelation(CDaoRelationInfo& relinfo);

Parâmetros

lpszName
O nome único do objeto de relação. O nome deve começar por uma letra e pode conter um máximo de 40 caracteres. Pode incluir números e caracteres sublinhados, mas não pode incluir pontuação ou espaços.

lpszTable
O nome da tabela principal na relação. Se a tabela não existir, o MFC lança uma exceção do tipo CDaoException.

lpszForeignTable
O nome da tabela estrangeira na relação. Se a tabela não existir, o MFC lança uma exceção do tipo CDaoException.

lAtributos
Um valor longo que contém informação sobre o tipo de relação. Pode usar este valor para impor a integridade referencial, entre outras coisas. Pode usar o operador bitwise-OR (|) para combinar qualquer um dos seguintes valores (desde que a combinação faça sentido):

• dbRelationUnique A relação é um para um.

• dbRelationDontEnforce A relação não é imposta (sem integridade referencial).

• dbRelationInherited A relação existe numa base de dados não atual que contém as duas tabelas anexadas.

• dbRelationUpdateCascade As atualizações irão ser feitas em cascata (para mais informações sobre cascatas, veja Observações).

• dbRelationDeleteCascade As eliminações vão acontecer em cascata.

lpszField
Um ponteiro para uma cadeia terminada por nulo contendo o nome de um campo na tabela primária (nomeada por lpszTable).

lpszForeignField
Um apontador para uma cadeia terminada por nulo contendo o nome de um campo na tabela estrangeira (nomeada por lpszForeignTable).

relinfo
Uma referência a um objeto CDaoRelationInfo que contém informação sobre a relação que pretende criar.

Observações

A relação não pode envolver uma consulta ou uma tabela anexada de uma base de dados externa.

Use a primeira versão da função quando a relação envolve um campo em cada uma das duas tabelas. Use a segunda versão quando a relação envolve múltiplos campos. O número máximo de corpos numa relação é 14.

Esta ação cria um objeto de relação DAO subjacente, mas este é um detalhe de implementação MFC, uma vez que o encapsulamento dos objetos de relação em MFC está contido na classe CDaoDatabase. A MFC não fornece uma disciplina para relações.

Se definir os atributos do objeto de relação para ativarem operações em cascata, o motor da base de dados atualiza ou elimina automaticamente registos em uma ou mais outras tabelas quando são feitas alterações em tabelas de chaves primárias relacionadas.

Por exemplo, suponha que estabelece uma relação de eliminação em cascata entre uma tabela de Clientes e uma tabela de Encomendas. Quando apagas registos da tabela de Clientes, os registos na tabela de Encomendas relacionados com esse cliente também são eliminados. Além disso, se estabeleceres relações de eliminação em cascata entre a tabela de Encomendas e outras tabelas, os registos dessas tabelas são automaticamente eliminados quando eliminas registos da tabela de Clientes.

Para informações relacionadas, consulte o tópico "CreateRelation Method" na Ajuda DAO.

CDaoDatabase::D eleteQueryDef

Chame esta função membro para eliminar o querydef especificado—consulta guardada—da CDaoDatabase coleção QueryDefs do objeto.

void DeleteQueryDef(LPCTSTR lpszName);

Parâmetros

lpszName
O nome da consulta guardada para apagar.

Observações

Depois, essa consulta deixa de ser definida na base de dados.

Para informações sobre a criação de objetos querydef, veja a classe CDaoQueryDef. Um objeto querydef fica associado a um objeto particular CDaoDatabase quando se constrói o CDaoQueryDef objeto, passando-lhe um ponteiro para o objeto da base de dados.

CDaoDatabase::D eleteRelation

Chame esta função membro para eliminar uma relação existente da coleção de Relações do objeto da base de dados.

void DeleteRelation(LPCTSTR lpszName);

Parâmetros

lpszName
O nome da relação a eliminar.

Observações

Depois disso, a relação deixou de existir.

Para informações relacionadas, consulte o tópico "Método Eliminar" na Ajuda do DAO.

CDaoDatabase::D eleteTableDef

Chame esta função membro para eliminar a tabela especificada e todos os seus dados da CDaoDatabase coleção TableDefs do objeto.

void DeleteTableDef(LPCTSTR lpszName);

Parâmetros

lpszName
O nome da definição da tabela para apagar.

Observações

Depois disso, essa tabela deixa de ser definida na base de dados.

Para informações sobre como criar objetos tabledef, veja a classe CDaoTableDef. Um objeto tabledef fica associado a um objeto particular CDaoDatabase quando se constrói o CDaoTableDef objeto, passando-lhe um ponteiro para o objeto da base de dados.

Para informações relacionadas, consulte o tópico "Método Eliminar" na Ajuda do DAO.

CDaoDatabase::Executar

Chame esta função membro para executar uma consulta de ação ou executar uma instrução SQL na base de dados.

void Execute(
    LPCTSTR lpszSQL,
    int nOptions = dbFailOnError);

Parâmetros

lpszSQL
Apontador para uma string terminada por null contendo um comando SQL válido para executar.

nOpções
Um inteiro que especifica opções relacionadas com a integridade da consulta. Pode usar o operador bitwise-OR (|) para combinar qualquer uma das seguintes constantes, desde que a combinação faça sentido. Por exemplo, não combinaria dbInconsistent com dbConsistent:

• dbDenyWrite Negar permissão de escrita a outros utilizadores.

• dbInconsistent (Padrão) Atualizações inconsistentes.

• dbConsistent Atualizações consistentes.

• dbSQLPassThrough Passagem SQL. Faz com que a instrução SQL seja passada para uma fonte de dados ODBC para processamento.

• dbFailOnError Reverta atualizações se ocorrer um erro.

• dbSeeChanges Gera um erro em tempo de execução se outro utilizador estiver a alterar os dados que está a editar.

Observações

Execute funciona apenas para consultas de ação ou consultas SQL pass-through que não devolvem resultados. Não funciona para consultas selecionadas, que devolvem registos.

Para uma definição e informações sobre consultas de ação, consulte os tópicos "Consulta de Ação" e "Método de Execução" na Ajuda do DAO.

Chame a função membro GetRecordsAffected do objeto da base de dados para determinar o número de registos afetados pela chamada mais recente Execute . Por exemplo, GetRecordsAffected devolve informação sobre o número de registos eliminados, atualizados ou inseridos ao executar uma consulta de ação. A contagem devolvida não reflete alterações nas tabelas relacionadas quando estão em vigor atualizações ou eliminações em cascata.

Execute Não devolve um conjunto de registos. Usar Execute em uma consulta que seleciona registos faz com que a MFC lance uma exceção do tipo CDaoException. (Não existe uma ExecuteSQL função membro análoga a CDatabase::ExecuteSQL.)

CDaoDatabase::GetConnect

Chame esta função membro para recuperar a cadeia de ligação usada para ligar o CDaoDatabase objeto a uma base de dados ODBC ou ISAM.

CString GetConnect();

Valor de retorno

A cadeia de ligação Open foi chamada com sucesso numa fonte de dados ODBC; caso contrário, uma cadeia vazia. Para um Microsoft Jet (. MDB), a cadeia está sempre vazia, a menos que a defina para uso com a dbSQLPassThrough opção usada com a função Executar membro ou usada na abertura de um conjunto de registos.

Observações

A cadeia fornece informação sobre a origem de uma base de dados aberta ou de uma base de dados usada numa consulta pass-through. A cadeia de ligação é composta por um especificador de tipo de base de dados e zero ou mais parâmetros separados por ponto e vírgula.

Consulte a função Open member para uma descrição de como a cadeia de ligação é criada. Depois de a cadeia de ligação estar definida na Open chamada, pode depois usá-la para verificar a definição e determinar o tipo, caminho, ID de utilizador, Palavra-passe ou fonte de dados ODBC da base de dados.

CDaoDatabase::GetName

Chame esta função membro para recuperar o nome da base de dados atualmente aberta, que é o nome de um ficheiro de base de dados existente ou o nome de uma fonte de dados ODBC registada.

CString GetName();

Valor de retorno

O caminho completo e o nome do ficheiro da base de datos se for bem-sucedido; caso contrário, um CString vazio.

Observações

Se a sua rede suportar a convenção uniforme de nomes (UNC), pode também especificar um caminho de rede—por exemplo, "\\\\MYSERVER\\MYSHARE\\MYDIR\\MYDB. MDB". (Barras duplas são obrigatórias nos literais de string porque "\" é o carácter de escape C++.)

Pode, por exemplo, querer mostrar este nome num título. Se ocorrer um erro enquanto o nome está a ser recuperado, o MFC lança uma exceção do tipo CDaoException.

O tipo de base de dados é indicado pelo ficheiro ou diretório para o qual o caminho aponta, da seguinte forma:

Para bases de dados ODBC como SQL Server e Oracle, a cadeia de ligação da base de dados identifica um nome de fonte de dados (DSN) que é registado pelo ODBC.

CDaoDatabase::GetQueryDefCount

Chame esta função membro para recuperar o número de consultas definidas na coleção QueryDefs da base de dados.

short GetQueryDefCount();

Valor de retorno

O número de consultas definidas na base de dados.

Observações

GetQueryDefCount é útil se precisares de passar por todos os querydefs na coleção QueryDefs. Para obter informações sobre uma determinada consulta na coleção, consulte GetQueryDefInfo.

CDaoDatabase::GetQueryDefInfo

Chame esta função membro para obter vários tipos de informação sobre uma consulta definida na base de dados.

void GetQueryDefInfo(
    int nIndex,
    CDaoQueryDefInfo& querydefinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetQueryDefInfo(
    LPCTSTR lpszName,
    CDaoQueryDefInfo& querydefinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

Parâmetros

nIndex
O índice da consulta pré-definida na coleção QueryDefs da base de dados, para consulta por índice.

querydefinfo
Uma referência a um objeto CDaoQueryDefInfo que devolve a informação solicitada.

dwInfoOptions
Opções que especificam que informação sobre o conjunto de registos recuperar. As opções disponíveis estão listadas aqui juntamente com o que fazem a função devolver no conjunto de registos:

• AFX_DAO_PRIMARY_INFO (Padrão) Nome, Tipo

• AFX_DAO_SECONDARY_INFO Informação principal mais: Data de Criação, Data da Última Atualização, Registos de Declarações, Atualizáveis

• AFX_DAO_ALL_INFO Informação primária e secundária mais: SQL, Connect, ODBCTimeout

lpszName
Uma string contendo o nome de uma consulta definida na base de dados, para consulta por nome.

Observações

São fornecidas duas versões da função para que possa selecionar uma consulta quer por índice na coleção QueryDefs da base de dados, quer pelo nome da consulta.

Para uma descrição da informação devolvida em querydefinfo, consulte a estrutura CDaoQueryDefInfo . Esta estrutura tem membros que correspondem aos itens de informação listados acima na descrição do dwInfoOptions. Se pedir um nível de informação, também obtém quaisquer níveis anteriores de informação.

CDaoDatabase::GetQueryTimeout

Chame esta função membro para recuperar o número atual de segundos para permitir antes de as operações subsequentes na base de dados ligada serem temporizadas.

short GetQueryTimeout();

Valor de retorno

Um inteiro curto contendo o valor de timeout em segundos.

Observações

Uma operação pode expirar devido a problemas de acesso à rede, tempo excessivo de processamento de consultas, e assim por diante. Enquanto a definição estiver em vigor, afeta todas as operações de abrir, adicionar novas, atualizar e eliminar em quaisquer conjuntos de registos associados a este CDaoDatabase objeto. Pode alterar a definição atual de timeout chamando o SetQueryTimeout. Alterar o valor de timeout da consulta para um conjunto de registos após a abertura não altera o valor do conjunto de registos. Por exemplo, as operações Move subsequentes não usam o novo valor. O valor padrão é inicialmente definido quando o motor da base de dados é inicializado.

O valor padrão para os tempos de espera das consultas é retirado do registo do Windows. Se não houver definição de registo, o padrão é 60 segundos. Nem todas as bases de dados suportam a capacidade de definir um valor de tempo de espera da consulta. Se definir um valor de timeout de consulta igual a 0, não ocorre timeout; e a comunicação com a base de dados pode deixar de responder. Este comportamento pode ser útil durante o desenvolvimento. Se a chamada falhar, o MFC lança uma exceção do tipo CDaoException.

Para informações relacionadas, consulte o tópico "QueryTimeout Property" na Ajuda DAO.

CDaoDatabase::GetRecordsAffected

Chame esta função membro para determinar o número de registos afetados pela chamada mais recente da função Executar membro.

long GetRecordsAffected();

Valor de retorno

Um inteiro longo contendo o número de registos afetados.

Observações

O valor devolvido inclui o número de registos eliminados, atualizados ou inseridos por uma consulta de ação executada com Execute. A contagem devolvida não reflete alterações nas tabelas relacionadas quando estão em vigor atualizações ou eliminações em cascata.

Para informações relacionadas, consulte o tópico "Propriedade Afetada por Registos" na Ajuda DAO.

CDaoDatabase::GetRelationCount

Chame esta função membro para obter o número de relações definidas entre tabelas na base de dados.

short GetRelationCount();

Valor de retorno

O número de relações definidas entre tabelas na base de dados.

Observações

GetRelationCount é útil se precisar de percorrer todas as relações definidas na coleção de Relações da base de dados. Para obter informações sobre uma dada relação na coleção, veja GetRelationInfo.

Para ilustrar o conceito de relação, considere uma tabela de Fornecedores e uma tabela de Produtos, que podem ter uma relação um-para-muitos. Nesta relação, um fornecedor pode fornecer mais do que um produto. Outras relações são um para um e muitos-para-muitos.

CDaoDatabase::GetRelationInfo

Chame esta função membro para obter informações sobre uma relação especificada na coleção de Relações da base de dados.

void GetRelationInfo(
    int nIndex,
    CDaoRelationInfo& relinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetRelationInfo(
    LPCTSTR lpszName,
    CDaoRelationInfo& relinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

Parâmetros

nIndex
O índice do objeto de relação na coleção de Relações da base de dados, para consulta por índice.

relinfo
Uma referência a um objeto CDaoRelationInfo que devolve a informação solicitada.

dwInfoOptions
Opções que especificam que informação sobre a relação recuperar. As opções disponíveis estão listadas aqui juntamente com o que fazem a função retornar sobre a relação:

• AFX_DAO_PRIMARY_INFO (Padrão) Nome, Tabela, Tabela Estrangeira

• AFX_DAO_SECONDARY_INFO Atributos, Informação de Campo

A Informação de Campo é um objeto CDaoRelationFieldInfo que contém os campos da tabela primária envolvida na relação.

lpszName
Uma cadeia contendo o nome do objeto de relação, para pesquisa por nome.

Observações

Duas versões desta função fornecem acesso quer por índice, quer por nome. Para uma descrição da informação devolvida em relinfo, consulte a estrutura CDaoRelationInfo . Esta estrutura tem membros que correspondem aos itens de informação listados acima na descrição do dwInfoOptions. Se solicitares informação a um nível, também recebes informação em quaisquer níveis anteriores.

CDaoDatabase::GetTableDefCount

Chame esta função membro para recuperar o número de tabelas definidas na base de dados.

short GetTableDefCount();

Valor de retorno

O número de defs de tabela definidos na base de dados.

Observações

GetTableDefCount é útil se precisares de percorrer todos os tabledefs na coleção TableDefs da base de dados. Para obter informações sobre uma dada tabela na coleção, consulte GetTableDefInfo.

CDaoDatabase::GetTableDefInfo

Chame esta função membro para obter vários tipos de informação sobre uma tabela definida na base de dados.

void GetTableDefInfo(
    int nIndex,
    CDaoTableDefInfo& tabledefinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

void GetTableDefInfo(
    LPCTSTR lpszName,
    CDaoTableDefInfo& tabledefinfo,
    DWORD dwInfoOptions = AFX_DAO_PRIMARY_INFO);

Parâmetros

nIndex
O índice do objeto tabledef na coleção TableDefs da base de dados, para consulta por índice.

tabledefinfo
Uma referência a um objeto CDaoTableDefInfo que devolve a informação solicitada.

dwInfoOptions
Opções que especificam que informação sobre a tabela recuperar. As opções disponíveis estão listadas aqui juntamente com o que fazem a função retornar sobre a relação:

• AFX_DAO_PRIMARY_INFO (Padrão) Nome, Atualizável, Atributos

• AFX_DAO_SECONDARY_INFO Informação principal mais: Data de Criação, Data da Última Atualização, Nome da Tabela de Fonte, Ligação

• AFX_DAO_ALL_INFO Informação primária e secundária mais: Regra de Validação, Texto de Validação, Contagem de Registos

lpszName
O nome do objeto tabledef, para pesquisa por nome.

Observações

São fornecidas duas versões da função para que possa selecionar uma tabela quer por índice na coleção TableDefs da base de dados, quer pelo nome da tabela.

Para uma descrição da informação devolvida em tabledefinfo, veja a estrutura CDaoTableDefInfo . Esta estrutura tem membros que correspondem aos itens de informação listados acima na descrição do dwInfoOptions. Se solicitar informação a um nível, também recebe informação para quaisquer níveis anteriores.

CDaoDatabase::GetVersion

Chame esta função membro para determinar a versão do ficheiro da base de dados Microsoft Jet.

CString GetVersion();

Valor de retorno

Um CString que indica a versão do ficheiro da base de dados associada ao objeto.

Observações

O valor devolvido representa o número de versão na forma "major.minor"; por exemplo, "3.0". O número de versão do produto (por exemplo, 3.0) consiste no número de versão (3), um ponto e o número de lançamento (0). As versões até à data são 1.0, 1.1, 2.0 e 3.0.

Para informações relacionadas, consulte o tópico "Propriedade de Versão" no DAO Help.

CDaoDatabase::IsOpen

Chame esta função membro para determinar se o CDaoDatabase objeto está atualmente aberto numa base de dados.

BOOL IsOpen() const;

Valor de retorno

Não nulo se o CDaoDatabase objeto estiver atualmente aberto; caso contrário, 0.

Observações

CDaoDatabase::m_pDAODatabase

Contém um ponteiro para a interface OLE para o objeto da base de dados DAO subjacente ao CDaoDatabase objeto.

Observações

Usa este ponteiro se precisares de aceder diretamente à interface do DAO.

Para informações sobre como ligar diretamente para o DAO, consulte a Nota Técnica 54.

CDaoDatabase::m_pWorkspace

Contém um ponteiro para o objeto CDaoWorkspace que contém o objeto da base de dados.

Observações

Usa este ponteiro se precisares de aceder diretamente ao espaço de trabalho. Por exemplo, para obter apontadores para outros objetos de base de dados na coleção Databases do workspace.

CDaoDatabase::Open

Deve chamar esta função membro para inicializar um objeto recém-construído CDaoDatabase que represente uma base de dados existente.

virtual void Open(
    LPCTSTR lpszName,
    BOOL bExclusive = FALSE,
    BOOL bReadOnly = FALSE,
    LPCTSTR lpszConnect = _T(""));

Parâmetros

lpszName
Uma expressão de string que é o nome de um Microsoft Jet existente (. MDB). Se o nome do ficheiro tiver uma extensão, é obrigatório. Se a sua rede suportar a convenção uniforme de nomenclatura (UNC), pode também especificar um caminho de rede, como "\\\\MYSERVER\\MYSHARE\\MYDIR\\MYDB. MDB". (Barras duplas são obrigatórias nos literais de string porque "\" é o carácter de escape C++.)

Algumas considerações aplicam-se ao usar o lpszName. Se:

• Refere-se a uma base de dados que já está aberta para acesso exclusivo por outro utilizador, o MFC lança uma exceção do tipo CDaoException. Apanha essa exceção para informar o utilizador de que a base de dados não está disponível.

• É uma cadeia vazia ("") e lpszConnect é "ODBC;", é exibida uma caixa de diálogo que lista todos os nomes de fontes de dados ODBC registados para que o utilizador possa selecionar uma base de dados. Deves evitar ligações diretas a fontes de dados ODBC; Use antes uma mesa anexa.

• Caso contrário, não se refere a uma base de dados existente ou a um nome válido de fonte de dados ODBC, o MFC lança uma exceção do tipo CDaoException.

bExclusivo
Um valor booleano que é TRUE se a base de dados for aberta para acesso exclusivo (não partilhado) e FALSE se a base de dados for aberta para acesso partilhado. Se omitir este argumento, a base de dados é aberta para acesso partilhado.

bReadOnly
Um valor booleano que é TRUE se a base de dados for aberta para acesso apenas de leitura e FALSE se a base de dados for aberta para acesso de leitura/escrita. Se omitires este argumento, a base de dados é aberta para acesso de leitura/escrita. Todos os conjuntos de registos dependentes herdam este atributo.

lpszConnect
Uma expressão string usada para abrir a base de dados. Esta cadeia constitui os argumentos de ligação ODBC. Deve fornecer os argumentos exclusivos e apenas de leitura para fornecer uma cadeia de origem. Se a base de dados for uma base de dados Microsoft Jet (. MDB), esta cadeia está vazia (""). A sintaxe do valor predefinido—_T("")—oferece portabilidade tanto para compilações Unicode como ANSI da sua aplicação.

Observações

Open associa a base de dados ao objeto DAO subjacente. Não podes usar o objeto da base de dados para construir objetos de recordet, tabledef ou querydef até que seja inicializado. Open adiciona o objeto da base de dados à coleção de Bases de Dados do espaço de trabalho associado.

Use os parâmetros da seguinte forma:

• Se estiver a abrir um Microsoft Jet (. MDB), usar o parâmetro lpszName e passar uma string vazia para o parâmetro lpszConnect ou passar uma string de palavra-passe do formulário "; PWD=password" se a base de dados estiver protegida por palavra-passe (. Apenas bases de dados MDB).

• Se estiver a abrir uma fonte de dados ODBC, passe uma cadeia válida de ligação ODBC em lpszConnect e uma cadeia vazia em lpszName.

Para informações relacionadas, consulte o tópico "Método OpenDatabase" na Ajuda do DAO.

É possível que uma ligação tente expirar se, por exemplo, o host do SGBD não estiver disponível. Se a tentativa de ligação falhar, Open lança uma exceção do tipo CDaoException.

As restantes observações aplicam-se apenas às bases de dados ODBC:

Se a base de dados for uma base de dados ODBC e os parâmetros na sua Open chamada não contêm informação suficiente para fazer a ligação, o driver ODBC abre uma caixa de diálogo para obter a informação necessária do utilizador. Quando chama Open, a sua cadeia de ligação, lpszConnect, é armazenada de forma privada e está disponível ao chamar a função membro do GetConnect .

Se quiser, pode abrir a sua própria caixa de diálogo antes de ligar Open para obter informações do utilizador, como uma palavra-passe, e depois adicionar essa informação à cadeia de ligação que passa para Open. Ou pode querer guardar a string de ligação que passa (talvez no registo do Windows) para a poder reutilizar da próxima vez que a sua aplicação chamar Open um CDaoDatabase objeto.

Também pode usar a string de ligação para múltiplos níveis de autorização de login (cada um para um objeto diferente CDaoDatabase ) ou para transmitir outra informação específica da base de dados.

CDaoDatabase::SetQueryTimeout

Chame esta função membro para sobrescrever o número padrão de segundos e permitir antes de as operações subsequentes na base de dados ligada esgotar o tempo.

void SetQueryTimeout(short nSeconds);

Parâmetros

nSegundos
O número de segundos a permitir antes de uma tentativa de consulta termina.

Observações

Uma operação pode expirar devido a problemas de acesso à rede, tempo excessivo de processamento de consultas, e assim por diante. Ligue SetQueryTimeout antes de abrir o seu conjunto de registos ou antes de chamar as funções membros AddNew, Update ou Delete do conjunto se quiser alterar o valor de timeout da consulta. A definição afeta todos os Open, AddNew, Update, e Delete chamadas subsequentes a quaisquer conjuntos de registos associados a este CDaoDatabase objeto. Alterar o valor de timeout da consulta para um conjunto de registos após a abertura não altera o valor do conjunto de registos. Por exemplo, as operações Move subsequentes não usam o novo valor.

O valor padrão para os tempos de espera das consultas é 60 segundos. Nem todas as bases de dados suportam a capacidade de definir um valor de tempo de espera da consulta. Se definir um valor de timeout de consulta igual a 0, não ocorre timeout; A comunicação com a base de dados pode deixar de responder. Este comportamento pode ser útil durante o desenvolvimento.

Para informações relacionadas, consulte o tópico "QueryTimeout Property" na Ajuda DAO.

Consulte também

Classe CObject
Gráfico de Hierarquia
Classe CDaoWorkspace
Classe CDaoRecordset
Classe CDaoTableDef
Classe CDaoQueryDef
Classe CDatabase
Classe CDaoException