CDaoTableDefInfo, structure

La CDaoTableDefInfo structure contient des informations sur un objet tabledef défini pour les objets d’accès aux données (DAO).

Remarque

DAO est pris en charge par le biais d’Office 2013. DAO 3.6 est la version finale, et elle est considérée comme obsolète.

Syntaxe

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
};

Paramètres

m_strName
Nomme de manière unique l’objet tabledef. Pour récupérer directement la valeur de cette propriété, appelez la fonction membre GetName de l’objet tabledef. Pour plus d’informations, consultez la rubrique « Name Property » dans l’aide de DAO.

m_bUpdatable
Indique si des modifications peuvent être apportées à la table. Le moyen rapide de déterminer si une table est pouvant être mise à jour consiste à ouvrir un CDaoTableDef objet pour la table et à appeler la fonction membre CanUpdate de l’objet. CanUpdate retourne toujours différent de zéro (TRUE) pour un objet tabledef nouvellement créé et 0 (FALSE) pour un objet tabledef attaché. Un nouvel objet tabledef ne peut être ajouté qu’à une base de données pour laquelle l’utilisateur actuel dispose d’une autorisation d’écriture. Si la table contient uniquement des champs non modifiables, CanUpdate retourne 0. Lorsqu’un ou plusieurs champs sont pouvant être mis à jour, CanUpdate retourne une valeur différente de zéro. Vous ne pouvez modifier que les champs pouvant être mis à jour. Pour plus d’informations, consultez la rubrique « Updatable Property » dans L’aide de DAO.

m_lAttributes
Spécifie les caractéristiques de la table représentée par l’objet tabledef. Pour récupérer les attributs actuels d’un tabledef, appelez sa fonction membre GetAttributes . La valeur retournée peut être une combinaison de ces constantes longues (à l’aide de l’opérateur bitwise-OR (|) :

• dbAttachExclusive Pour les bases de données qui utilisent le moteur de base de données Microsoft Jet, indique que la table est une table jointe ouverte pour une utilisation exclusive.

• dbAttachSavePWD Pour les bases de données qui utilisent le moteur de base de données Microsoft Jet, indique que l’ID utilisateur et le mot de passe de la table jointe sont enregistrés avec les informations de connexion.

• dbSystemObject Indique que la table est une table système fournie par le moteur de base de données Microsoft Jet. (En lecture seule.)

• dbHiddenObject Indique que la table est une table masquée fournie par le moteur de base de données Microsoft Jet (pour une utilisation temporaire). (En lecture seule.)

• dbAttachedTable Indique que la table est une table jointe à partir d’une base de données non ODBC, telle qu’une base de données Paradox.

• dbAttachedODBC Indique que la table est une table jointe à partir d’une base de données ODBC, telle que Microsoft SQL Server.

m_dateCreated
Date et heure de création de la table. Pour récupérer directement la date de création de la table, appelez la fonction membre GetDateCreated de l’objet CDaoTableDef associé à la table. Pour plus d’informations, voir Commentaires ci-dessous. Pour plus d’informations, consultez la rubrique « DateCreated, LastUpdated Properties » dans l’aide de DAO.

m_dateLastUpdated
Date et heure de la modification la plus récente apportée à la conception de la table. Pour récupérer directement la date de la dernière mise à jour de la table, appelez la fonction membre GetDateLastUpdated de l’objet CDaoTableDef associé à la table. Pour plus d’informations, voir Commentaires ci-dessous. Pour plus d’informations, consultez la rubrique « DateCreated, LastUpdated Properties » dans l’aide de DAO.

m_strSrcTableName
Spécifie le nom d’une table jointe le cas échéant. Pour récupérer directement le nom de la table source, appelez la fonction membre GetSourceTableName de l’objet CDaoTableDef associé à la table.

m_strConnect
Fournit des informations sur la source d’une base de données ouverte. Vous pouvez vérifier cette propriété en appelant la fonction membre GetConnect de votre CDaoTableDef objet. Pour plus d’informations sur les chaînes de connexion, consultez GetConnect.

m_strValidationRule
Valeur qui valide les données dans les champs tabledef à mesure qu’elles sont modifiées ou ajoutées à une table. La validation est prise en charge uniquement pour les bases de données qui utilisent le moteur de base de données Microsoft Jet. Pour récupérer directement la règle de validation, appelez la fonction membre GetValidationRule de l’objet CDaoTableDef associé à la table. Pour plus d’informations, consultez la rubrique « ValidationRule Property » dans L’aide de DAO.

m_strValidationText
Valeur qui spécifie le texte du message que votre application doit afficher si la règle de validation spécifiée par la propriété ValidationRule n’est pas satisfaite. Pour plus d’informations, consultez la rubrique « ValidationText Property » dans l’aide de DAO.

m_lRecordCount
Nombre d’enregistrements accessibles dans un objet tabledef. Ce paramètre de propriété est en lecture seule. Pour récupérer directement le nombre d’enregistrements, appelez la fonction membre GetRecordCount de l’objet CDaoTableDef . La documentation pour GetRecordCount décrire le nombre d’enregistrements plus loin. Notez que la récupération de ce nombre peut prendre beaucoup de temps si la table contient de nombreux enregistrements.

Notes

Le tabledef est un objet de la classe CDaoTableDef. Les références à Primary, Secondary et All ci-dessus indiquent comment les informations sont retournées par la fonction membre GetTableDefInfo dans la classe CDaoDatabase.

Les informations récupérées par la fonction membre CDaoDatabase ::GetTableDefInfo sont stockées dans une CDaoTableDefInfo structure. Appelez la GetTableDefInfo fonction membre de l’objet CDaoDatabase dans lequel la collection TableDefs est stockée. CDaoTableDefInfo définit également une Dump fonction membre dans les builds de débogage. Vous pouvez utiliser Dump pour vider le contenu d’un CDaoTableDefInfo objet.

Les paramètres de date et d’heure sont dérivés de l’ordinateur sur lequel la table de base a été créée ou mise à jour la dernière fois. Dans un environnement multiutilisateur, les utilisateurs doivent obtenir ces paramètres directement à partir du serveur de fichiers pour éviter les incohérences dans les paramètres de propriété DateCreated et LastUpdated.

Spécifications

En-tête : afxdao.h

Voir aussi

Structures, styles, rappels et tables de messages
CDaoTableDef, classe
CDaoDatabase, classe