Estrutura CDaoTableDefInfo

Artigo
08/25/2010

The CDaoTableDefInfo estrutura contém informações sobre um objeto definiçãodetabela definida para objetos de acesso a dados (DAO).

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 o objeto definiçãodetabela exclusivamente.Para recuperar o valor desta propriedade diretamente, chame GetNamefunção de membro .Para obter mais informações, consulte o tópico "Propriedade de nome" na Ajuda do DAO.
m_bUpdatable
Indica se podem ser feitas alterações em tabela.A maneira rápida de determinar se uma tabela é atualizável é em aberto um CDaoTableDef objeto da tabela e telefonar do objeto CanUpdatefunção de membro .CanUpdate sempre retorna (diferente de zeroTRUE) para um objeto definiçãodetabela recém-criado e 0 (FALSE) para um objeto definiçãodetabela anexado.Pode ser acrescentado a um novo objeto definiçãodetabela somente a um banco de dados para o qual o usuário corrente tem permissão de gravar.Se a tabela contiver somente nonupdatable campos, CanUpdate Retorna 0. Quando um ou mais campos são atualizáveis, CanUpdate Retorna um diferente de zero. Você pode edição somente os campos atualizáveis.Para obter mais informações, consulte o tópico "Propriedade atualizável" na Ajuda do DAO.
m_lAttributes
Especifica as características da tabela representada pelo objeto definiçãodetabela.Para recuperar os atributos corrente de um definiçãodetabela telefonar seus GetAttributesfunção de membro .O valor retornado pode ser uma combinação das constantes longos (usando o operador bit a bit ou (**|**operador)):
- dbAttachExclusive Para bancos de dados que usam o mecanismo de banco de dados 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 Microsoft Jet, indica que a ID de usuário e senha para a tabela de anexo são salvos com as informações de conexão.
- dbSystemObject Indica que a tabela é uma tabela de sistema fornecida pelo mecanismo de banco de dados Microsoft Jet.(Somente leitura.)
- dbHiddenObject Indica que a tabela é uma tabela oculta fornecida pelo mecanismo de banco de dados Microsoft Jet (para uso temporário).(Somente leitura.)
- dbAttachedTable Indica que a tabela é uma tabela anexada de um banco de dados não-ODBC, sistema autônomo um banco de dados do Paradox.
- dbAttachedODBC Indica que a tabela é uma tabela anexada de um banco de dados ODBC, sistema autônomo o Microsoft SQL servidor.
m_dateCreated
A data e time em que a tabela foi criada.Para recuperar a data de criação, a tabela diretamente telefonar o GetDateCreated função de membro do CDaoTableDef objeto associado à tabela. Para obter mais informações, consulte comentários abaixo.Para obter informações relacionadas, consulte o tópico "DateCreated e LastUpdated Properties" na Ajuda do DAO.
m_dateLastUpdated
A data e time da alterar mais recente feita ao design da tabela.Para recuperar a data em que a tabela foi atualizado pela última vez, diretamente telefonar o GetDateLastUpdated função de membro do CDaoTableDef objeto associado à tabela. Para obter mais informações, consulte comentários abaixo.Para obter informações relacionadas, consulte o tópico "DateCreated e LastUpdated Properties" na Ajuda do DAO.
m_strSrcTableName
Especifica o nome de uma tabela anexado se houver.Para recuperar diretamente o nome de tabela de fonte, telefonar o GetSourceTableName função de membro do CDaoTableDef objeto associado à tabela.
m_strConnect
Fornece informações sobre fonte de um banco de dados em aberto.Você pode verificar essa propriedade, chamando o GetConnect função de membro de seuCDaoTableDef objeto. Para obter mais informações sobre como conectar-se seqüências de caracteres, consulte GetConnect.
m_strValidationRule
Um valor que valida sistema autônomo dados em campos definiçãodetabela à medida que eles são alterados ou adicionados a uma tabela.Validação é suportada somente para bancos de dados que usam o mecanismo de banco de dados Microsoft Jet.Para recuperar diretamente a regra de validação telefonar o GetValidationRule função de membro do CDaoTableDef objeto associado à tabela. Para obter informações relacionadas, consulte o tópico "Propriedade RegraDeValidação" na Ajuda do DAO.
m_strValidationText
Um valor que especifica o texto da mensagem de que seu aplicativo deve exibir se a regra de validação especificada pela propriedade RegraDeValidação não é satisfeita.Para obter informações relacionadas, consulte o tópico "Propriedade TextoDeValidação" na Ajuda do DAO.
m_lRecordCount
O número de registros acessados em um objeto definiçãodetabela.A configuração dessa propriedade é somente leitura.Para recuperar a contagem de registro diretamente telefonar o GetRecordCount função de membro do CDaoTableDef objeto. A documentação de GetRecordCount descreve ainda mais a contagem de registro. Observe que recuperar essa contagem pode ser uma operação demorada se a tabela contiver muitos registros.

Comentários

A definiçãodetabela é um objeto de classe CDaoTableDef.As referências a primária, secundária e All acima indicam como as informações fornecidas pelo GetTableDefInfo função de membro na classe CDaoDatabase.

Informações recuperadas pelo CDaoDatabase::GetTableDefInfo armazenado em um função de membroCDaoTableDefInfo estrutura. Chamar o GetTableDefInfo função de membro da CDaoDatabase objeto cuja coleção TableDefs o objeto definiçãodetabela está armazenado. CDaoTableDefInfo também define um Dump cria a função de membro na depurar. Você pode usar Dump Despejar o Sumário de um CDaoTableDefInfo objeto.

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