CDaoTableDefInfo, structure

Article
03/04/2013

La structure d' CDaoTableDefInfo contient des informations sur un objet tabledef défini pour les objets d'accès aux données (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
};

Paramètres

m_strName
Appelé uniquement l'objet tabledef.Pour récupérer la valeur de cette propriété directement, appelez la fonction membre de GetName de l'objet tabledef.Pour plus d'informations, consultez la rubrique « propriété Name » dans l'aide de DAO.
m_bUpdatable
Indique si les modifications peuvent être apportées à la table.La méthode rapide pour déterminer si un tableau peut être mise à jour est d'ouvrir un objet d' CDaoTableDef pour le tableau et d'appeler la fonction membre de CanUpdate de l'objet.CanUpdate retourne toujours une valeur différente de zéro (TRUE) pour un objet et un 0 nouvellement créé tabledef (FALSE) pour un objet joint tabledef.Un nouvel objet tabledef peut être ajouté uniquement à une base de données pour laquelle l'utilisateur actuel prend l'autorisation en écriture.Si le tableau contient uniquement les champs nonupdatable, retourne 0 d' CanUpdate .Lorsqu'un ou plusieurs champs peuvent être mise à jour, CanUpdate retourne une valeur différente de zéro.Vous pouvez modifier uniquement les champs pouvant être mis à jour.Pour plus d'informations, consultez la rubrique « propriété actualisable » 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 définis d'un tabledef, appelez la fonction membre de GetAttributes .La valeur retournée peut être une combinaison de ces longues constantes (à l'aide de l'opérateur de bits OR (|) opérateur) :
- dbAttachExclusive pour les bases de données qui utilisent le moteur de base de données Microsoft Jet, indique la table est une table jointe ouvert pour un usage exclusif.
- dbAttachSavePWD pour les bases de données qui utilisent le moteur de base de données Microsoft Jet, indique que l'ID d'utilisateur et le mot de passe pour la table jointe sont enregistrés avec les informations de connexion.
- dbSystemObject indique la table est une table système fournie par le moteur de base de données Microsoft Jet.(En lecture seule.)
- dbHiddenObject indique la table est une table masqué fourni par le moteur de base de données Microsoft Jet (pour une utilisation provisoire).(En lecture seule.)
- dbAttachedTable indique la table est une table jointe d'une base de données de non-ODBC, telle qu'une base de données de paradox.
- dbAttachedODBC indique la table est une table jointe d'une base de données ODBC, telle que Microsoft SQL Server.
m_dateCreated
La date et l'heure de la table a été créé.Pour extraire directement la date que le tableau a été créé, appelle la fonction membre de GetDateCreated de l'objet d' CDaoTableDef associé à la table.Consultez les commentaires ci-dessous pour plus d'informations.Pour plus d'informations, consultez la rubrique « DateCreated, les propriétés de LastUpdated » dans l'aide de DAO.
m_dateLastUpdated
Les date et heure de la modification apportée la plus récente à la création de la table.Pour extraire directement la date que le tableau a été de la dernière mise à jour, appelle la fonction membre de GetDateLastUpdated de l'objet d' CDaoTableDef associé à la table.Consultez les commentaires ci-dessous pour plus d'informations.Pour plus d'informations, consultez la rubrique « DateCreated, les propriétés de LastUpdated » dans l'aide de DAO.
m_strSrcTableName
En spécifie le nom d'une table jointe si.Pour extraire directement le nom de table source, appelez la fonction membre de GetSourceTableName de l'objet d' CDaoTableDef associé à la table.
m_strConnect
Fournit des informations sur la source de la base de données ouverte.Vous pouvez activer cette propriété en appelant la fonction membre de GetConnect de votre objet d' CDaoTableDef .Pour plus d'informations sur connectez les chaînes, consultez GetConnect.
m_strValidationRule
Une valeur qui valide les données dans les champs tabledef lorsqu'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 extraire directement la règle de validation, appelez la fonction membre de GetValidationRule de l'objet d' CDaoTableDef associé à la table.Pour plus d'informations, consultez la rubrique « propriété de ValidationRule » dans l'aide de DAO.
m_strValidationText
Valeur qui spécifie le texte du message indiquant que votre application doit afficher si la règle de validation spécifiée par la propriété de ValidationRule n'est pas satisfaite.Pour plus d'informations, consultez la rubrique « propriété de ValidationText » dans l'aide de DAO.
m_lRecordCount
Le nombre d'enregistrements accessibles dans un objet tabledef.Ce paramètre de propriété est en lecture seule.Pour extraire directement le nombre d'enregistrements, appelez la fonction membre de GetRecordCount de l'objet d' CDaoTableDef .La documentation de GetRecordCount décrit le nombre d'enregistrements plus approfondie.Notez que l'extrait ce compteur peut être une longue opération si le tableau contient plusieurs enregistrements.

Notes

Le tabledef est un objet de classe CDaoTableDef.Les références à primaire, à secondaire et, tous en haut indiquent comment les informations sont retournées par la fonction membre de GetTableDefInfo dans la classe CDaoDatabase.

Des informations extraites par la fonction membre de CDaoDatabase::GetTableDefInfo sont stockées dans une structure d' CDaoTableDefInfo .Appelez la fonction membre d' GetTableDefInfo de l'objet d' CDaoDatabase dans lequel la collection de tabledefs l'objet tabledef est enregistré.CDaoTableDefInfo définit également une fonction membre d' Dump dans les versions debug.Vous pouvez utiliser Dump pour faire un dump du contenu d'un objet d' CDaoTableDefInfo .

Les paramètres de date et d'heure sont dérivés à partir de l'ordinateur sur lequel la table de base a été créée ou dernier mis à jour.Dans un environnement multi-utilisateur, les utilisateurs doivent obtenir ces paramètres directement du serveur de fichiers pour éviter des anomalies dans les paramètres de propriété de DateCreated et de LastUpdated.