Compartilhar via


Classe de CDaoTableDef

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

class CDaoTableDef : public CObject

Membros

5t434xff.collapse_all(pt-br,VS.110).gifConstrutores public

Nome

Descrição

CDaoTableDef::CDaoTableDef

Constrói um objeto de CDaoTableDef .

5t434xff.collapse_all(pt-br,VS.110).gifMé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.

5t434xff.collapse_all(pt-br,VS.110).gifMembros 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.

    ObservaçãoObservação

    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

  1. Em todos os casos, primeiro criar um objeto de CDaoTableDef , fornecendo um ponteiro para um objeto de CDaoDatabase que pertence à tabela.

  2. 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.

      DicaDica

      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.

Hierarquia de herança

CObject

CDaoTableDef

Requisitos

Cabeçalho: afxdao.h

Consulte também

Referência

Classe de CObject

Gráfico de hierarquia

Classe de CDaoDatabase

Classe de CDaoRecordset