CDaoQueryDefInfo, structure
La structure d' CDaoQueryDefInfo contient des informations sur un objet querydef défini pour les objets d'accès aux données (DAO).
struct CDaoQueryDefInfo
{
CString m_strName; // Primary
short m_nType; // Primary
COleDateTime m_dateCreated; // Secondary
COleDateTime m_dateLastUpdated; // Secondary
BOOL m_bUpdatable; // Secondary
BOOL m_bReturnsRecords; // Secondary
CString m_strSQL; // All
CString m_strConnect; // All
short m_nODBCTimeout; // All
};
Paramètres
m_strName
Appelé uniquement l'objet querydef.Pour plus d'informations, consultez la rubrique « propriété Name » dans l'aide de DAO.Appel CDaoQueryDef::GetName pour récupérer cette propriété directement.m_nType
Une valeur qui indique le type opérationnel d'un objet querydef.La valeur peut être l'une des opérations suivantes :dbQSelect sélectionnez (la requête sélectionne des enregistrements.
Action dedbQAction(la requête déplace ou les données de modifications mais ne retourne pas d'enregistrements.
Analyse croisée dedbQCrosstab(la requête retourne des données dans un format comme une feuille de calcul.
Suppression dedbQDelete(la requête supprime un jeu de lignes spécifiées.
Mise à jour dedbQUpdate(la requête modifie un ensemble d'enregistrements.
dbQAppend add (la requête ajoute de nouveaux enregistrements à la fin d'une table ou d'une requête.
Faire-tableau dedbQMakeTable(la requête crée une table d'un recordset.
Définition de données dedbQDDL(la requête affecte la structure des tables ou de leurs éléments.
Convertisseur dedbQSQLPassThrough— l'instruction SQL est passé directement à la base de données principale, sans traitement intermédiaire.
Union dedbQSetOperation(la requête crée un objet recordset de type instantané contenant les données de tous les enregistrements spécifiés dans deux ou plusieurs tables avec tous enregistrements en double supprimés.Pour inclure des doublons, ajoutez le mot clé TOUT dans l'instruction SQL des querydef.
dbQSPTBulk elle est utilisée avec dbQSQLPassThrough pour spécifier une requête qui ne retourne pas d'enregistrements.
[!REMARQUE]
Pour créer une requête SQL direct, vous ne définissez pas la constante de dbQSQLPassThrough .Cela est défini automatiquement par le moteur de base de données Microsoft Jet lorsque vous créez un objet querydef et définissez la propriété de connecter.
Pour plus d'informations, consultez la rubrique « propriété de type » dans l'aide de DAO.
m_dateCreated
La date/heure à laquelle le querydef a été créé.Pour extraire directement la date que le querydef 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.Consultez également 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 au querydef.Pour extraire directement la date que le tableau a été de la dernière mise à jour, appelle la fonction membre de GetDateLastUpdated du querydef.Consultez les commentaires ci-dessous pour plus d'informations.Et consultez la rubrique « DateCreated, les propriétés de LastUpdated » dans l'aide de DAO.m_bUpdatable
Indique si les modifications peuvent être apportées à un objet querydef.Si cette propriété est TRUE, le querydef peut être mise à jour ; sinon, il n'est pas.Un moyen pouvant être mis à jour la définition de la requête de l'objet querydef peuvent être modifiés.La propriété peut être mise à jour d'un objet querydef est définie à TRUE si la définition de la requête peut être mise à jour, même si le recordset obtenue n'est pas modifiable.Pour récupérer cette propriété directement, appelez la fonction membre de CanUpdate des querydef.Pour plus d'informations, consultez la rubrique « propriété actualisable » dans l'aide de DAO.m_bReturnsRecords
Indique si une requête SQL directement à une base de données externe retourne des enregistrements.Si cette propriété est TRUE, la requête retourne des enregistrements.Pour extraire directement cette propriété, appelez CDaoQueryDef::GetReturnsRecords.Toutes les requêtes SQL direct aux enregistrements externes de retour de base de données.Par exemple, une instruction SQL METTRE À JOUR met à jour des enregistrements sans retourner des enregistrements, tandis que une instruction SQL SÉLECTIONNER retourne des enregistrements.Pour plus d'informations, consultez la rubrique « propriété de ReturnsRecords » dans l'aide de DAO.m_strSQL
L'instruction SQL qui définit la requête a exécuté par un objet querydef.La propriété SQL contient une instruction SQL qui détermine comment les enregistrements sont sélectionnés, regroupés, et classés lorsque vous exécutez la requête.Vous pouvez utiliser la requête pour sélectionner des enregistrements à inclure dans une feuille de réponse dynamique ou un objet recordset de type instantané.Vous pouvez également définir des requêtes en bloc pour modifier des données sans retourner des enregistrements.Vous pouvez récupérer la valeur de cette propriété directement en appelant la fonction membre de GetSQL des querydef.m_strConnect
Fournit des informations sur la source de la base de données utilisée dans une requête directe.Ces informations prennent la forme d'une chaîne de connexion.Pour plus d'informations sur connectez les chaînes, et des informations sur récupérer la valeur de cette propriété directement, consultez la fonction membre de CDaoDatabase::GetConnect .m_nODBCTimeout
Le nombre de secondes que le moteur de base de données Microsoft Jet attend avant qu'une erreur de délai d'attente se produise lorsqu'une requête est exécutée sur une base de données ODBC.Lorsque vous utilisez une base de données ODBC, telle que Microsoft SQL Server, celle-ci peut être relativement en raison de le trafic réseau ou de l'utilisation intensive du serveur ODBC.Plutôt que l'attente dure indéfiniment, vous pouvez spécifier la durée pendant laquelle le moteur Microsoft Jet attend avant qu'il produit une erreur.La valeur du délai d'attente par défaut est 60 secondes.Vous pouvez récupérer la valeur de cette propriété directement en appelant la fonction membre de GetODBCTimeout des querydef.Pour plus d'informations, consultez la rubrique « propriété d'ODBCTimeout » dans l'aide de DAO.
Notes
Le querydef est un objet de classe CDaoQueryDef.Les références à primaire, à secondaire et, tous en haut indiquent comment les informations sont retournées par la fonction membre de GetQueryDefInfo dans la classe CDaoDatabase.
Des informations extraites par la fonction membre de CDaoDatabase::GetQueryDefInfo sont stockées dans une structure d' CDaoQueryDefInfo .Appelez GetQueryDefInfo pour l'objet de base de données dans lequel la collection de QueryDefs l'objet querydef est enregistré.CDaoQueryDefInfo 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' CDaoQueryDefInfo .La classe CDaoDatabase fournit également des fonctions membres pour accéder directement à toutes les propriétés retournées dans un objet d' CDaoQueryDefInfo , vous devrez probablement rarement appeler GetQueryDefInfo.
Lorsque vous ajoutez un nouvel champ ou objet paramètre à la collection de champs ou des paramètres d'un objet querydef, une exception est levée si la base de données sous-jacente ne prend pas en charge le type de données spécifié pour le nouvel objet.
Les paramètres de date et d'heure sont dérivés à partir de l'ordinateur sur lequel le querydef a été créé ou dernier mis à jour.Dans un environnement multi-utilisateur, les utilisateurs doivent obtenir ces paramètres directement du serveur de fichiers à l'aide de la commande de NET TIME d'éviter des anomalies dans les paramètres de propriété de DateCreated et de LastUpdated.
Configuration requise
Header: afxdao.h