Estrutura CDaoTableDefInfo

Artigo
02/25/2013

O CDaoTableDefInfo estrutura contém informações sobre um objeto tabledef definido 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
Nomes exclusivamente o objeto tabledef.Para recuperar o valor desta propriedade diretamente, ligue para o objeto tabledef GetName funçã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 à tabela.Uma maneira rápida de determinar se uma tabela é atualizável é abrir uma CDaoTableDef de objeto para a tabela e chamar o objeto CanUpdate função de membro.CanUpdatesempre retorna diferente de zero (TRUE) para um objeto tabledef recém-criado e 0 (FALSE) para um objeto tabledef anexado.Pode ser acrescentado um novo objeto tabledef 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 de nonupdatable CanUpdate retorna 0.Quando um ou mais campos são atualizáveis, CanUpdate retorna diferente de zero.Você pode editar 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 tabledef.Para recuperar os atributos atuais de uma tabledef, chame seu GetAttributes função de membro.O valor retornado pode ser uma combinação de constantes longos (usando o (bit a bit ou**|**operador)):
- dbAttachExclusive bancos de dados que usam o mecanismo de banco de dados Microsoft Jet, indica a tabela é uma tabela anexada aberta para uso exclusivo.
- dbAttachSavePWD bancos de dados que usam o mecanismo de banco de dados Microsoft Jet, indica que o ID de usuário e senha para a tabela anexada são salvas com as informações de conexão.
- dbSystemObject indica a tabela é uma tabela de sistema fornecida pelo mecanismo de banco de dados Microsoft Jet.(Somente leitura.)
- dbHiddenObject indica a tabela é uma tabela oculta fornecida pelo mecanismo de banco de dados Microsoft Jet (para uso temporário).(Somente leitura.)
- dbAttachedTable indica a tabela é uma tabela anexada de um banco de dados não-ODBC, como um banco de dados do Paradox.
- dbAttachedODBC indica a tabela é uma tabela anexada de um banco de dados ODBC, como Microsoft SQL Server.
m_dateCreated
A data e hora que a tabela foi criada.Para recuperar diretamente a data em que a tabela foi criada, chame o GetDateCreated função de membro de CDaoTableDef objeto associado com a tabela.Consulte comentários abaixo para obter mais informações.Para obter informações relacionadas, consulte o tópico "DateCreated e LastUpdated Properties" na Ajuda do DAO.
m_dateLastUpdated
A data e 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 o GetDateLastUpdated função de membro de CDaoTableDef objeto associado com a tabela.Consulte comentários abaixo para obter mais informações.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 da tabela de origem, chame o GetSourceTableName função de membro de CDaoTableDef objeto associado com a tabela.
m_strConnect
Fornece informações sobre a origem de um banco de dados aberto.Você pode verificar essa propriedade chamando o GetConnect função de membro de sua CDaoTableDef objeto.Para obter mais informações sobre seqüências de conexão, consulte GetConnect.
m_strValidationRule
Um valor que valida os dados em campos tabledef como 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, chame o GetValidationRule função de membro de CDaoTableDef objeto associado com a 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 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 tabledef.A configuração dessa propriedade é somente leitura.Para recuperar diretamente a contagem de registros, chame o GetRecordCount função de membro de CDaoTableDef objeto.A documentação de GetRecordCount descreve ainda mais a contagem de registros.Observe que recuperar essa contagem pode ser uma operação demorada se a tabela contiver muitos registros.

Comentários

Tabledef é um objeto da classe CDaoTableDef.Referências primária, secundária e tudo acima indicam como as informações são retornadas pelo GetTableDefInfo função de membro na classe CDaoDatabase.

As informações recuperadas pelo CDaoDatabase::GetTableDefInfo função de membro é armazenada em um CDaoTableDefInfo estrutura.Chamar o GetTableDefInfo função de membro de CDaoDatabase objeto cuja coleção TableDefs o objeto tabledef está armazenado.CDaoTableDefInfotambém define um Dump membro na depuração compilações.Você pode usar Dump para despejar o conteúdo de um CDaoTableDefInfo objeto.

As configurações de data e hora são derivadas do computador no qual a tabela de base foi criada ou atualizado 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 no DateCreated e configurações de propriedade de LastUpdated.