Classe de CDaoTableDef

Article
03/26/2013

Représente la définition stockée d'une table de base ou d'une table jointe.

class CDaoTableDef : public CObject

Membres

Constructeurs publics

Nom	Description
CDaoTableDef::CDaoTableDef	Crée un objet de CDaoTableDef .

Méthodes publiques

Nom	Description
CDaoTableDef::Append	Ajoute une nouvelle table dans la base de données.
CDaoTableDef::CanUpdate	Retourne une valeur différente de zéro si le tableau peut être mis à jour (vous pouvez modifier la définition des champs ou des propriétés du tableau).
CDaoTableDef::Close	Ferme un tabledef ouvert.
CDaoTableDef::Create	Crée un tableau qui peut être ajouté à la base de données à l'aide de ajoutez.
CDaoTableDef::CreateField	Appelé pour créer un champ d'une table.
CDaoTableDef::CreateIndex	Appelé pour créer un index pour un tableau.
CDaoTableDef::DeleteField	Appelée pour supprimer un champ d'une table.
CDaoTableDef::DeleteIndex	Appelée pour supprimer un index d'un tableau.
CDaoTableDef::GetAttributes	Retourne une valeur qui indique un ou plusieurs caractéristiques d'un objet d' CDaoTableDef .
CDaoTableDef::GetConnect	Retourne une valeur qui fournit des informations sur la source d'un tableau.
CDaoTableDef::GetDateCreated	Retourne la date et l'heure de la table de base sous-jacente à un objet d' CDaoTableDef a été créée.
CDaoTableDef::GetDateLastUpdated	Retourne la date et l'heure de la modification apportée la plus récente à la conception de la table de base.
CDaoTableDef::GetFieldCount	Retourne une valeur qui représente le nombre de champs dans le tableau.
CDaoTableDef::GetFieldInfo	Retourne les types spécifiques d'informations sur les champs du tableau.
CDaoTableDef::GetIndexCount	Retourne le nombre d'index du tableau.
CDaoTableDef::GetIndexInfo	Retourne les types spécifiques d'informations sur les index du tableau.
CDaoTableDef::GetName	Retourne le nom défini par l'utilisateur du tableau.
CDaoTableDef::GetRecordCount	Retourne le nombre d'enregistrements dans la table.
CDaoTableDef::GetSourceTableName	Retourne une valeur qui spécifie le nom de table jointe dans la base de données source.
CDaoTableDef::GetValidationRule	Retourne une valeur qui valide les données dans un domaine lorsqu'il est modifié ou ajouté à une table.
CDaoTableDef::GetValidationText	Retourne une valeur qui spécifie le texte du message que votre application affiche si la valeur d'un objet champ ne satisfait pas à la règle de validation spécifiée.
CDaoTableDef::IsOpen	Retourne une valeur différente de zéro si le tableau est ouvert.
CDaoTableDef::Open	Ouvre un tabledef existant enregistré dans la collection du tabledef de la base de données.
CDaoTableDef::RefreshLink	Met à jour les informations de connexion pour une table jointe.
CDaoTableDef::SetAttributes	Définit une valeur qui indique un ou plusieurs caractéristiques d'un objet d' CDaoTableDef .
CDaoTableDef::SetConnect	Définit une valeur qui fournit des informations sur la source d'un tableau.
CDaoTableDef::SetName	Définit le nom de la table.
CDaoTableDef::SetSourceTableName	Définit une valeur qui spécifie le nom d'une table jointe dans la base de données source.
CDaoTableDef::SetValidationRule	Définit une valeur qui valide les données dans un domaine lorsqu'il est modifié ou ajouté à une table.
CDaoTableDef::SetValidationText	Définit une valeur qui spécifie le texte du message que votre application affiche si la valeur d'un objet champ ne satisfait pas à la règle de validation spécifiée.

Données membres publiques

Nom	Description
CDaoTableDef::m_pDAOTableDef	Pointeur vers l'interface DAO sous-jacent à l'objet de tabledef.
CDaoTableDef::m_pDatabase	Base de données source de cette table.

Notes

Chaque objet de base de données DAO gère une collection, TableDefs appelé, qui contient tous les objets tabledef enregistrés de DAO.

Vous manipulez une définition de table à l'aide d'un objet d' CDaoTableDef .Par exemple, vous pouvez :

Examinez la structure de champ et d'index de tous les variables locales, jointe, ou la table externe dans une base de données.
Appelez les fonctions membres d' SetConnect et d' SetSourceTableName pour les tables jointes, puis utilisez la fonction membre d' RefreshLink pour mettre à jour des connexions aux tables jointes.
Appelez la fonction membre d' CanUpdate pour déterminer si vous pouvez les définitions de champ d'édition dans le tableau.
Obtenez ou définissez les états de validation à l'aide de GetValidationRule et SetValidationRule, et les fonctions membres d' GetValidationText et d' SetValidationText .
Utilisez la fonction membre de Ouvrir pour créer une table, une feuille de réponse dynamique, ou un objet de type instantané d' CDaoRecordset .

[!REMARQUE]

Les classes de bases de données DAO sont séparées des classes de base de données MFC basée sur (Open Database Connectivity).Tous les noms de classes de bases de données DAO ont le préfixe « CDao ».Vous pouvez encore accéder aux sources de données ODBC avec les classes DAO ; les classes DAO offrent généralement des fonctionnalités améliorées car elles sont spécifiques au moteur de base de données Microsoft Jet.

Pour utiliser des objets de tabledef d'utiliser un tableau existant ou créer une table

Dans tous les cas, construisez d'abord un objet d' CDaoTableDef , en fournissant un pointeur vers un objet de CDaoDatabase auquel la table appartient.

Effectuez ensuite les éléments suivants, selon que vous voulez :

Pour utiliser un existant a enregistré le tableau, appelez la fonction membre d' Ouvrez de l'objet de tabledef, en fournissant le nom de la table enregistré.
Pour créer une table, appelez la fonction membre de Create de l'objet de tabledef, en fournissant le nom de la table.Appelez CreateField et CreateIndex pour ajouter des champs et des index à la table.

Appelez ajoutez enregistrer la table en l'ajoutant à la collection des tabledefs de la base de données.Créer place le tabledef dans un état ouvert, donc après avoir appelé Créer que vous n'appelez pas Ouvrir.

Conseil
La façon la plus facile de créer les tables enregistrées est de créer et de les enregistrer dans votre base de données à l'aide de Microsoft Access.Vous pouvez ouvrir et les utiliser dans votre code MFC.

Pour utiliser l'objet de tabledef que vous avez ouvert ou l'avez créé, créez ou ouvrez un objet d' CDaoRecordset , en spécifiant le nom du tabledef avec une valeur de dbOpenTable dans le paramètre d' nOpenType .

Pour utiliser un objet de tabledef pour créer un objet d' CDaoRecordset , vous créez généralement ou ouvrez un tabledef comme décrit ci-dessus, puis construisez un objet recordset, en passant un pointeur vers l'objet de tabledef lorsque vous appelez CDaoRecordset::Open.Le tabledef que vous passez doit être dans un état ouvert.Pour plus d'informations, consultez la classe CDaoRecordset.

Lorsque vous avez fini d'utiliser un objet de tabledef, appelez sa fonction membre de Fermez ; détruisez l'objet de tabledef.