La structure CDaoTableDefInfo a la forme suivante:
struct CDaoTableDefInfo
{
nbsp ; CString m_str&Name ; / / Primaire
BOOL m_bUpdatable ; / / Primaire
long m_lAttributes ; / / Primaire
COleDateTime m_dateCreated ; / / Secondaire
COleDateTime m_dateLastUpdated ; / / Secondaire
CString m_strSrcTableName ; / / Secondaire
CString m_strConnect ; / / Secondaire
CString m_strValidationRule ; / / Toutes les
CString m_strValidationText ; / / Toutes les
long m_lRecordCount ; / / Toutes les
}
La structure CDaoTableDefInfo contient des informations sur un objet tabledef définie pour les objets de données access (DAO). L'objet tabledef est un objet de classe CDaoTableDef. Les références à la primaire, secondaire et tous les ci-dessus indiquent comment l'information est retournée par la fonction membre GetTableDefInfo dans la classe CDaoDatabase.
Membres
m_strName
Noms uniques de l'objet tabledef. Pour récupérer directement la valeur de cette propriété, appelez la fonction de membre de l'objet tabledef GetName . Pour plus d'informations, consultez la rubrique « Nom de propriété » dans l'aide de DAO.
m_bUpdatable
Indique si des changements peuvent être effectués à la table. La voie rapide pour déterminer si une table est mise à jour est d'ouvrir un objet CDaoTableDef 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 (faux) d'un objet tabledef ci-joint. Un nouvel objet tabledef peut être ajouté uniquement à une base de données pour lequel l'utilisateur actuel dispose de l'autorisation d'écriture. Si le tableau contient uniquement les champs nonupdatable, CanUpdate retourne 0. Lorsqu'un ou plusieurs champs sont actualisables, CanUpdate retourne zéro. Vous pouvez modifier uniquement les champs actualisables. 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 actuels d'un objet tabledef, appelez sa fonction membre de GetAttributes . La valeur retournée peut être une combinaison de ces constantes longs (à l'aide de l'opérateur de bits OR (|)):
m_dateCreated
La date et l'heure de que création de la table. Pour récupérer directement la date de que la table a été créée, 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 propriétés » dans l'aide de DAO.
m_dateLastUpdated
La date et l'heure de la plus récente modification apportée à la conception de la table. Pour récupérer directement la date de que 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 propriétés » dans l'aide de DAO.
m_strSrcTableName
Spécifie le nom d'une table attachée le cas échéant. Pour récupérer directement le nom de 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 objet CDaoTableDef . Pour plus d'informations sur les chaînes de connexion, voir GetConnect.
m_strValidationRule
Une valeur valide les données dans les champs de l'objet tabledef comme ils sont modifiées ou ajoutées à un tableau. Validation est pris 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 « Propriété ValideSi (ValidationRule) » dans l'aide de DAO.
m_strValidationText
Une 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é ValideSi (ValidationRule) n'est pas satisfaite. Pour plus d'informations, consultez la rubrique « Propriété ValidationText » dans l'aide de DAO.
m_lRecordCount
Le nombre d'enregistrements dans un objet tabledef. Paramétrage de cette propriété est en lecture seule. Pour récupérer directement le nombre de dossier, appeler la fonction membre GetRecordCount de l'objet CDaoTableDef . La documentation de GetRecordCount décrit le nombre record de plus. Notez que récupération ce nombre peut être une opération de temps si la table contient des enregistrements de nombreux.
Commentaires
Information récupérée par la fonction membre CDaoDatabase::GetTableDefInfo est stockée dans une structure CDaoTableDefInfo . Appelez la fonction membre GetTableDefInfo de l'objet CDaoDatabase dans dont la collection TableDefs de l'objet tabledef est stocké. CDaoTableDefInfo définit également une fonction membre Dump dans les versions de débogage. Vous pouvez utiliser Dump pour vider le contenu d'un objet CDaoTableDefInfo.
Les paramètres de date et d'heure sont dérivées de l'ordinateur sur lequel la table de base a été créée ou mise à jour. Dans un environnement multi-utilisateur, les utilisateurs doivent obtenir ces paramètres directement depuis le serveur de fichiers afin d'éviter des divergences dans la DateCreated et les paramètres de propriété LastUpdated.
Pour plus d'informations sur l'utilisation de ceci et autres structures d'information sur DAO MFC, consultez l'article Collections DAO : informations sur les objets DAO dans le Guide du programmeur Visual C++.
Voir aussinbsp ;CDaoTableDef, CDaoDatabase, CDaoTableDef::CanUpdate, CDaoTableDef::GetAttributes, CDaoTableDef::GetDateCreated, CDaoTableDef::GetDateLastUpdated, CDaoTableDef::GetRecordCount, CDaoTableDef::GetSourceTable&Name, CDaoTableDef::GetValidationRule, CDaoTableDef::GetValidationText