Classe CDaoTableDef

Artigo
06/10/2015

Representa a definição armazenada de uma tabela de base ou uma tabela anexado.

class CDaoTableDef : public CObject

Membros

Construtores public

Nome	Descrição
CDaoTableDef::CDaoTableDef	Constrói um objeto de CDaoTableDef .

Métodos públicos

Nome	Descrição
CDaoTableDef::Append	Adiciona uma nova tabela ao banco de dados.
CDaoTableDef::CanUpdate	Retorna diferente de zero se a tabela pode ser atualizada (você pode alterar a definição dos campos ou propriedades da tabela).
CDaoTableDef::Close	Fecha um tabledef aberto.
CDaoTableDef::Create	Cria uma tabela que pode ser adicionada ao banco de dados usando acrescentar.
CDaoTableDef::CreateField	Chamado para criar um campo para uma tabela.
CDaoTableDef::CreateIndex	Chamado para criar um índice para uma tabela.
CDaoTableDef::DeleteField	Chamado para excluir um campo de uma tabela.
CDaoTableDef::DeleteIndex	Chamado para excluir um índice de uma tabela.
CDaoTableDef::GetAttributes	Retorna um valor que indica uma ou mais características de um objeto de CDaoTableDef .
CDaoTableDef::GetConnect	Retorna um valor que fornece informações sobre a origem de uma tabela.
CDaoTableDef::GetDateCreated	Retorna a data e a hora que a tabela de base subjacente um objeto de CDaoTableDef foi criada.
CDaoTableDef::GetDateLastUpdated	Retorna a data e hora da alteração mais recente feita ao design da tabela de base.
CDaoTableDef::GetFieldCount	Retorna um valor que representa o número de campos na tabela.
CDaoTableDef::GetFieldInfo	Retorna tipos específicos de informações sobre os campos na tabela.
CDaoTableDef::GetIndexCount	Retorna o número de índices para a tabela.
CDaoTableDef::GetIndexInfo	Retorna tipos específicos de informações sobre os índices para a tabela.
CDaoTableDef::GetName	Retorna o nome definido pelo usuário da tabela.
CDaoTableDef::GetRecordCount	Retorna o número de registros na tabela.
CDaoTableDef::GetSourceTableName	Retorna um valor que especifica o nome da tabela no banco de dados de origem.
CDaoTableDef::GetValidationRule	Retorna um valor que valida os dados em um campo que é modificado ou adicionado a uma tabela.
CDaoTableDef::GetValidationText	Retorna um valor que especifica o texto de mensagem que seu aplicativo exibe se o valor de um objeto do campo não satisfaz a regra de validação especificada.
CDaoTableDef::IsOpen	Retorna diferente de zero se a tabela é aberta.
CDaoTableDef::Open	Abre um tabledef armazenado existente na coleção de TableDef de banco de dados.
CDaoTableDef::RefreshLink	Atualiza informações de conexão para uma tabela anexado.
CDaoTableDef::SetAttributes	Define um valor que indica uma ou mais características de um objeto de CDaoTableDef .
CDaoTableDef::SetConnect	Define um valor que fornece informações sobre a origem de uma tabela.
CDaoTableDef::SetName	Define o nome da tabela.
CDaoTableDef::SetSourceTableName	Define um valor que especifica o nome de uma tabela anexado no banco de dados de origem.
CDaoTableDef::SetValidationRule	Define um valor que valida os dados em um campo que é modificado ou adicionado a uma tabela.
CDaoTableDef::SetValidationText	Define um valor que especifica o texto de mensagem que seu aplicativo exibe se o valor de um objeto do campo não satisfaz a regra de validação especificada.

Membros públicos de dados

Nome	Descrição
CDaoTableDef::m_pDAOTableDef	Um ponteiro para a interface de DAO que é subjacente ao objeto de tabledef.
CDaoTableDef::m_pDatabase	O banco de dados de origem para a tabela.

Comentários

Cada objeto de banco de dados de DAO mantém uma coleção, TableDefs chamado, que contém todos os objetos salvos de tabledef de DAO.

Você manipula a definição de tabela usando um objeto de CDaoTableDef . Por exemplo, você pode:

Examine a estrutura do campo e de índice da tabela local, anexado, ou externa em um banco de dados.
Chamar funções de membro de SetConnect e de SetSourceTableName para tabelas anexados, e use a função de membro de RefreshLink para atualizar conexões para tabelas anexados.
Chame a função de membro de CanUpdate para determinar se você pode editar definições de campo da tabela.
Obter ou definir condições de validação usando GetValidationRule e SetValidationRule, e as funções de membro de GetValidationText e de SetValidationText .
Use a função de membro de Abrir para criar uma tabela, um dynaset-, ou um objeto de CDaoRecordset de instantâneo- tipo.

Dica

As classes de banco de dados de DAO são distintas de classes do banco de dados MFC baseado em Open Database Connectivity (ODBC).Todos os nomes de classe de banco de dados de DAO têm o prefixo “CDao”.Você ainda pode acessar fontes de dados ODBC com as classes de DAO; as classes de DAO geralmente oferecem recursos superiores como são específicas para o mecanismo de banco de dados Microsoft Jet.

Para usar objetos de tabledef para trabalhar com uma tabela existente ou criar uma nova tabela

Em todos os casos, primeiro criar um objeto de CDaoTableDef , fornecendo um ponteiro para um objeto de CDaoDatabase que pertence à tabela.
Faça a seguir, dependendo do que você deseja:
- Para usar um existente salvar a tabela, chama a função de membro de Abrir do objeto de tabledef, fornecendo o nome da tabela salvo.
- Para criar uma nova tabela, chame a função de membro de Criar do objeto de tabledef, fornecendo o nome da tabela. Chame CreateField e CreateIndex para adicionar campos e índices à tabela.
- Chame acrescentar para salvar a tabela adicionando um à coleção de TableDefs de banco de dados. Criar coloca o tabledef em um estado aberto, logo após chamando Criar que você não chama Abrir.
  
  Dica
  
  A maneira mais fácil de criar tabelas salvos é criá-las e os armazena no seu banco de dados usando o Microsoft Access.Em seguida você pode abri-los e usar em seu código MFC.

Para usar o objeto de tabledef você abriu ou criado, cria e abre um objeto de CDaoRecordset , especificando o nome de tabledef com um valor de dbOpenTable no parâmetro de nOpenType .

Para usar um objeto de tabledef para criar um objeto de CDaoRecordset , você normalmente cria ou abre um tabledef conforme descrito acima, então constrói um objeto do conjunto de registros, passando um ponteiro ao objeto de tabledef quando você chama CDaoRecordset::Open. O tabledef que você passa deve estar em um estado aberto. Para obter mais informações, consulte a classe CDaoRecordset.

Quando você terminar de usar um objeto de tabledef, chame a função de membro de Fechar ; destrua no objeto de tabledef.