Compartilhar via


Estrutura CDaoDatabaseInfo

A estrutura CDaoDatabaseInfo contém informações sobre um objeto de banco de dados definido para DAOs (objetos de acesso a dados).

Observação

O DAO tem suporte por meio do Office 2013. DAO 3.6 é a versão final e é considerada obsoleta.

Sintaxe

struct CDaoDatabaseInfo
{
    CString m_strName;       // Primary
    BOOL m_bUpdatable;       // Primary
    BOOL m_bTransactions;    // Primary
    CString m_strVersion;    // Secondary
    long m_lCollatingOrder;  // Secondary
    short m_nQueryTimeout;   // Secondary
    CString m_strConnect;    // All
};

Parâmetros

m_strName
Nomeia exclusivamente o objeto de banco de dados. Para recuperar essa propriedade diretamente, chame CDaoDatabase::GetName. Para detalhes, confira o tópico "Propriedade Name" na Ajuda do DAO.

m_bUpdatable
Indica se é possível fazer alterações no banco de dados. Para recuperar essa propriedade diretamente, chame CDaoDatabase::CanUpdate. Para obter detalhes, confira o tópico "Propriedade Updatable" na Ajuda do DAO.

m_bTransactions
Indica se uma fonte de dados dá suporte a transações – a gravação de uma série de alterações que podem ser revertidas (canceladas) ou confirmadas (salvas). Se um banco de dados for baseado no mecanismo de banco de dados do Microsoft Jet, a propriedade Transactions não será zero, e você poderá usar transações. Outros mecanismos de banco de dados podem não dar suporte a transações. Para recuperar essa propriedade diretamente, chame CDaoDatabase::CanTransact. Para obter detalhes, confira o tópico "Propriedade Transactions" na Ajuda do DAO.

m_strVersion
Indica a versão do mecanismo de banco de dados do Microsoft Jet. Para recuperar o valor dessa propriedade diretamente, chame a função membro GetName do objeto de banco de dados. Para ober detalhes, confira o tópico "Propriedade Version" na Ajuda do DAO.

m_lCollatingOrder
Especifica a sequência da ordem de classificação no texto para comparação ou classificação de cadeias de caracteres. Entre os valores possíveis estão:

  • dbSortGeneral Use a ordem de classificação geral (inglês, francês, alemão, português, italiano e espanhol moderno).

  • dbSortArabic Use a ordem de classificação do árabe.

  • dbSortCyrillic Use a ordem de classificação do russo.

  • dbSortCzech Use a ordem de classificação do tcheco.

  • dbSortDutch Use a ordem de classificação do holandês.

  • dbSortGreek Use a ordem de classificação do grego.

  • dbSortHebrew Use a ordem de classificação do hebraico.

  • dbSortHungarian Use a ordem de classificação do húngaro.

  • dbSortIcelandic Use a ordem de classificação do islandês.

  • dbSortNorwdan Use a ordem de classificação do norueguês ou dinamarquês.

  • dbSortPDXIntl Use a ordem de classificação da Paradox International.

  • dbSortPDXNor Use a ordem de classificação da Paradox do norueguês ou dinamarquês.

  • dbSortPDXSwe Use a ordem de classificação Paradox do sueco ou finlandês.

  • dbSortPolish Use a ordem de classificação do polonês.

  • dbSortSpanish Use a ordem de classificação do espanhol.

  • dbSortSwedFin Use a ordem de classificação do sueco ou finlandês.

  • dbSortTurkish Use a ordem de classificação do turco.

  • dbSortUndefined A ordem de classificação é indefinida ou desconhecida.

Para mais informações, confira o tópico "Personalizando configurações do Registro do Windows para acesso a dados" na Ajuda do DAO.

m_nQueryTimeout
O número de segundos que o mecanismo de banco de dados do Microsoft Jet aguarda antes que ocorra um erro de tempo limite quando uma consulta é executada em um banco de dados ODBC. O valor padrão do tempo limite é de 60 segundos. Quando QueryTimeout é definido como 0, nenhum tempo limite ocorre; isso pode fazer com que o programa pare de responder. Para recuperar o valor dessa propriedade diretamente, chame a função membro GetQueryTimeout do objeto de banco de dados. Para obter detalhes, confira o tópico "Propriedade QueryTimeout" na Ajuda do DAO.

m_strConnect
Fornece informações sobre a origem de um banco de dados aberto. Para obter informações sobre cadeias de caracteres de conexão e sobre como recuperar o valor dessa propriedade diretamente, consulte a função membro CDaoDatabase::GetConnect. Para mais informações, confira o tópico "Propriedade Connect" na ajuda do DAO.

Comentários

O banco de dados é um objeto DAO subjacente a um objeto MFC da classe CDaoDatabase. As referências a Primary, Secondary e All acima indicam como as informações são retornadas pela função membro CDaoWorkspace::GetDatabaseInfo.

As informações recuperadas pela função membro CDaoWorkspace::GetDatabaseInfo são armazenadas em uma estrutura CDaoDatabaseInfo. Chame GetDatabaseInfo para o objeto CDaoWorkspace em cuja coleção de banco de dados o objeto de banco de dados está armazenado. CDaoDatabaseInfo também define uma função membro Dump em builds de depuração. Você pode usar Dump para despejar o conteúdo de um objeto CDaoDatabaseInfo.

Requisitos

Cabeçalho: afxdao.h

Confira também

Estruturas, estilos, retornos de chamada e mapas de mensagem
Classe CDaoWorkspace
Classe CDaoDatabase