Estrutura CDaoTableDefInfo

A estrutura CDaoTableDefInfo contém informações sobre um objeto tabledef definido para DAO (objetos de acesso a dados).

Sintaxe

struct CDaoTableDefInfo
{
    CString m_strName;               // Primary
    BOOL m_bUpdatable;               // Primary
    long m_lAttributes;              // Primary
    COleDateTime m_dateCreated;      // Secondary
    COleDateTime m_dateLastUpdated;  // Secondary
    CString m_strSrcTableName;       // Secondary
    CString m_strConnect;            // Secondary
    CString m_strValidationRule;     // All
    CString m_strValidationText;     // All
    long m_lRecordCount;             // All
};

Parâmetros

m_strName
Nomeia exclusivamente o objeto tabledef. Para recuperar o valor dessa propriedade diretamente, chame a função membro GetName do objeto tabledef. Para obter mais informações, confira o tópico "Propriedade Name" na Ajuda do DAO.

m_bUpdatable
Indica se é possível fazer alterações na tabela. A maneira rápida de determinar se uma tabela é atualizável é abrir um objeto CDaoTableDef para a tabela e chamar a função membro CanUpdate do objeto. CanUpdate sempre retorna diferente de zero (TRUE) para um objeto tabledef recém-criado e 0 (FALSE) para um objeto tabledef anexado. Um novo objeto tabledef pode ser acrescentado somente a um banco de dados para o qual o usuário atual tem permissão de gravação. Se a tabela contiver apenas campos não atualizáveis, CanUpdate retornará 0. Quando um ou mais campos são atualizáveis, CanUpdate retorna diferente de zero. Você pode editar apenas os campos atualizáveis. Para obter mais informações, confira o tópico "Propriedade Updatable" na ajuda do DAO.

m_lAttributes
Especifica as características da tabela representada pelo objeto tabledef. Para recuperar os atributos atuais de um tabledef, chame a respectiva função membro GetAttributes. O valor retornado pode ser uma combinação destas constantes longas (usando o operador OR (|) bit a bit):

• dbAttachExclusive Para bancos de dados que usam o mecanismo de banco de dados do Microsoft Jet, indica que a tabela é uma tabela anexada aberta para uso exclusivo.

• dbAttachSavePWD Para bancos de dados que usam o mecanismo de banco de dados do Microsoft Jet, indica que a ID do usuário e a senha da tabela anexada são salvas com as informações de conexão.

• dbSystemObject Indica que a tabela é uma tabela do sistema fornecida pelo mecanismo de banco de dados do Microsoft Jet. (Somente leitura.)

• dbHiddenObject Indica que a tabela é uma tabela oculta fornecida pelo mecanismo de banco de dados do Microsoft Jet. (Somente leitura.)

• dbAttachedTable Indica que a tabela é uma tabela anexada de um banco de dados não ODBC, como um banco de dados Paradox.

• dbAttachedODBC Indica que a tabela é uma tabela anexada de um banco de dados ODBC, como o Microsoft SQL Server.

m_dateCreated
A data e a hora em que a tabela foi criada. Para recuperar diretamente a data em que a tabela foi criada, chame a função membro GetDateCreated do objeto CDaoTableDef associado à tabela. Confira Comentários abaixo para obter mais informações. Para obter informações relacionadas, confira o tópico "Propriedades DateCreated, LastUpdated" na ajuda do DAO.

m_dateLastUpdated
A data e a hora da alteração mais recente feita no design da tabela. Para recuperar diretamente a data em que a tabela foi atualizada pela última vez, chame a função membro GetDateLastUpdated do objeto CDaoTableDef associado à tabela. Confira Comentários abaixo para obter mais informações. Para obter informações relacionadas, confira o tópico "Propriedades DateCreated, LastUpdated" na ajuda do DAO.

m_strSrcTableName
Especifica o nome de uma tabela anexada, se houver. Para recuperar diretamente o nome da tabela de origem, chame a função membro GetSourceTableName do objeto CDaoTableDef associado à tabela.

m_strConnect
Fornece informações sobre a origem de um banco de dados aberto. Você pode verificar essa propriedade chamando a função membro GetConnect do objeto CDaoTableDef. Para obter mais informações sobre cadeias de conexão, confira GetConnect.

m_strValidationRule
Um valor que valida os dados nos campos tabledef à medida que são alterados ou adicionados a uma tabela. A validação será compatível apenas com bancos de dados que usam o mecanismo de banco de dados do Microsoft Jet. Para recuperar diretamente a regra de validação, chame a função membro GetValidationRule do objeto CDaoTableDef associado à tabela. Para obter informações relacionadas, consulte o tópico "Propriedade ValidationRule" na ajuda do DAO.

m_strValidationText
Um valor que especifica o texto da mensagem que seu aplicativo deve exibir se a regra de validação especificada pela propriedade ValidationRule não é atendida. Para obter informações relacionadas, consulte o tópico "Propriedade ValidationText" na ajuda do DAO.

m_lRecordCount
O número de registros acessados em um objeto tabledef. Essa configuração de propriedade é somente leitura. Para recuperar diretamente a contagem de registros, chame a função membro GetRecordCount do objeto CDaoTableDef. A documentação de GetRecordCount descreve a contagem de registros em mais detalhes. Observe que recuperar essa contagem poderá ser uma operação demorada se a tabela contiver muitos registros.

Comentários

O tabledef é um objeto da classe CDaoTableDef. As referências a Primary, Secondary e All acima indicam como as informações são retornadas pela função membro GetTableDefInfo na classe CDaoDatabase.

As informações recuperadas pela função membro CDaoDatabase::GetTableDefInfo são armazenadas em uma estrutura CDaoTableDefInfo. Chame a função membro GetTableDefInfo do objeto CDaoDatabase em cuja coleção TableDefs o objeto tabledef está armazenado. CDaoTableDefInfo 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 CDaoTableDefInfo.

As configurações de data e hora são derivadas do computador no qual a tabela base foi criada ou atualizada pela última vez. Em um ambiente multiusuário, os usuários devem obter essas configurações diretamente do servidor de arquivos para evitar discrepâncias nas configurações de propriedade DateCreated e LastUpdated.

Requisitos

Cabeçalho: afxdao.h

Confira também

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