Estrutura CDaoTableDefInfo

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

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 de forma única o objeto tabledef. Para recuperar diretamente o valor desta propriedade, chame a função membro GetName do objeto tabledef. Para mais informações, consulte o tópico "Nome de Propriedade" no DAO Help.

m_bUpdatable
Indica se podem ser feitas alterações à tabela. A forma rápida de determinar se uma tabela é atualizável é abrir um CDaoTableDef objeto para a tabela e chamar a função membro CanUpdate do objeto. CanUpdate sempre devolve não nulo (TRUE) para um objeto tabledef recém-criado e 0 (FALSE) para um objeto tabledef anexado. Um novo objeto tabledef só pode ser adicionado a uma base de dados para a qual o utilizador atual tenha permissão de escrita. Se a tabela contiver apenas campos não atualizáveis, CanUpdate retorna 0. Quando um ou mais campos são atualizáveis, devolve CanUpdate não zero. Só podes editar os campos atualizáveis. Para mais informações, consulte o tópico "Propriedade Atualizável" no DAO Help.

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

• dbAttachExclusive Para bases de dados que utilizam o motor de base de dados Microsoft Jet, indica que a tabela é uma tabela anexada aberta para uso exclusivo.

• dbAttachSavePWD Para bases de dados que utilizam o motor de base de dados Microsoft Jet, indica que o ID de utilizador e a palavra-passe da tabela anexada são guardados com a informação de ligação.

• dbSystemObject Indica que a tabela é uma tabela de sistema fornecida pelo motor de base de dados Microsoft Jet. (Só leitura.)

• dbHiddenObject Indica que a tabela é uma tabela oculta fornecida pelo motor de base de dados Microsoft Jet (para uso temporário). (Só leitura.)

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

• dbAttachedODBC Indica que a tabela é uma tabela associada de uma base de dados ODBC, como o Microsoft SQL Server.

m_dateCreated
A data e 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 CDaoTableDef objeto associado à tabela. Consulte os comentários abaixo para mais informações. Para informações relacionadas, consulte o tópico "DateCreated, LastUpdated Properties" na Ajuda do DAO.

m_dateLastUpdated
A data e hora da alteração mais recente feita ao design da mesa. Para recuperar diretamente a data em que a tabela foi atualizada pela última vez, chame a função membro GetDateLastUpdated do CDaoTableDef objeto associado à tabela. Consulte os comentários abaixo para mais informações. Para informações relacionadas, consulte o tópico "DateCreated, LastUpdated Properties" na Ajuda do DAO.

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

m_strConnect
Fornece informação sobre a origem de uma base de dados aberta. Pode verificar esta propriedade chamando a função membro GetConnect do seu CDaoTableDef objeto. Para mais informações sobre cordas de conexão, veja GetConnect.

m_strValidationRule
Um valor que valida os dados nos campos de definição de tabela à medida que são alterados ou adicionados a uma tabela. A validação é suportada apenas para bases de dados que utilizam o motor de base de dados Microsoft Jet. Para recuperar diretamente a regra de validação, chame a função membro GetValidationRule do CDaoTableDef objeto associado à tabela. Para informações relacionadas, consulte o tópico "ValidationRule Property" na Ajuda do DAO.

m_strValidationText
Um valor que especifica o texto da mensagem que a sua aplicação deve apresentar caso a regra de validação especificada pela propriedade ValidationRule não seja satisfeita. Para informações relacionadas, consulte o tópico "ValidationText Property" na Ajuda do DAO.

m_lRecordCount
O número de registos acedidos num objeto de tabela de defesa. Esta configuração de propriedade é só de leitura. Para recuperar diretamente a contagem de registos, chame a função membro GetRecordCount do CDaoTableDef objeto. A documentação para GetRecordCount descreve ainda mais a contagem de registos. Note que recuperar esta contagem pode ser uma operação demorada se a tabela contiver muitos registos.

Observações

O tabledef é um objeto da classe CDaoTableDef. As referências a Primário, Secundário e Todos acima indicam como a informação é devolvida pela função membro GetTableDefInfo na classe CDaoDatabase.

A informação recuperada pela função membro CDaoDatabase::GetTableDefInfo é armazenada numa CDaoTableDefInfo estrutura. Chame a GetTableDefInfo função membro do CDaoDatabase objeto em cuja coleção TableDefs está armazenada o objeto tabledef. CDaoTableDefInfo também define uma Dump função membro em builds de depuração. Podes usar Dump para despejar o conteúdo de um CDaoTableDefInfo objeto.

As definições de data e hora são derivadas do computador onde a tabela base foi criada ou atualizada pela última vez. Num ambiente multiutilizador, os utilizadores devem obter estas definições diretamente do servidor de ficheiros para evitar discrepâncias nas propriedades DateCreated e LastUpdate.

Requerimentos

Cabeçalho:afxdao.h

Consulte também

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