CDaoQueryDefInfo Structure

La structure CDaoQueryDefInfo a la forme suivante:

struct CDaoQueryDefInfo
{
 nbsp ; CString m_str&Name ;               / / Primaire
   m_nType courtes ;                   / / Primaire
   COleDateTime m_dateCreated ;      / / Secondaire
   COleDateTime m_dateLastUpdated ;  / / Secondaire
   BOOL m_bUpdatable ;               / / Secondaire
   BOOL m_bReturnsRecords ;          / / Secondaire
   CString m_strSQL ;                / / Toutes les
   CString m_strConnect ;            / / Toutes les
   m_nODBCTimeout courtes ;            / / Toutes les
}

La structure CDaoQueryDefInfo contient des informations sur un objet querydef définie pour les objets de données access (DAO). L'objet querydef est un objet de classe CDaoQueryDef. Les références à la primaire, secondaire et tous les ci-dessus indiquent comment l'information est retournée par la fonction membre GetQueryDefInfo dans la classe CDaoDatabase.

Membres

m_strName

Unique nom l'objet querydef. Pour plus d'informations, consultez la rubrique « Nom de propriété » dans l'aide de DAO. Appelez CDaoQueryDef::GetName pour récupérer cette propriété directement.

m_nType

Une valeur qui indique le type de fonctionnement d'un objet querydef. La valeur peut être l'une des opérations suivantes:

• dbQSelect  ;  Sélectionnez — la requête sélectionne les enregistrements.
  
  
• dbQActio&nnbsp ;  Action — la requête, déplace ou modifie des données mais ne retourne pas d'enregistrements.
  
  
• dbQCrosstab  ;  Analyse croisée — la requête retourne des données dans un format de feuille de calcul comme.
  
  
• dbQDelete  ;  Supprimer — la requête supprime un jeu de lignes spécifiés.
  
  
• dbQUpdate  ;  Mise à jour — la requête modifie un jeu d'enregistrements.
  
  
• dbQAppe&ndnbsp ;  Ajouter — la requête ajoute de nouveaux enregistrements à la fin d'une table ou une requête.
  
  
• dbQMakeTable  ;  Création de table, la requête crée une nouvelle table d'un objet recordset.
  
  
• dbQDDL  ;  Définition des données — la requête affecte la structure de tables ou de leurs parties.
  
  
• dbQSQLPassThrough  ;  Authentification unique — l'instruction SQL est passée directement à la base de données principale, sans traitement intermédiaire.
  
  
• dbQSetOperatio&nnbsp ;  Union — la requête crée un objet recordset de type instantané contenant des données provenant de documents tous spécifiés dans deux ou plusieurs tables avec les doublons supprimés. Pour inclure les doublons, ajoutez le mot clé tous les dans l'instruction SQL de l'objet querydef.
  
  
• dbQSPTBulk  ;  Utilisé avec dbQSQLPassThrough pour spécifier une requête qui ne retourne pas d'enregistrements.

  &Notenbsp ;  Pour créer une requête SQL directe, vous ne définissez pas la constante dbQSQLPassThrough . Ceci 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é Connect.

  Pour plus d'informations, consultez la rubrique « Type bien » dans l'aide de DAO.

m_dateCreated

La date et l'heure de que création de l'objet querydef. Pour récupérer directement la date de que la création de l'objet querydef, appelez la fonction membre GetDateCreated de l'objet CDaoTableDef associé à la table. Pour plus d'informations, voir commentaires ci-dessous. Voir aussi 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 à l'objet querydef. 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 querydef. Pour plus d'informations, voir commentaires ci-dessous. Et consultez la rubrique « DateCreated, LastUpdated propriétés » dans l'aide de DAO.

m_bUpdatable

Indique si changements peuvent être effectués pour un objet querydef. Si cette propriété est TRUE, l'objet querydef est actualisable ; par ailleurs, il n'est pas. Updatable signifie la que définition de l'objet querydef la requête peut être modifiée. La propriété modifiable d'un objet querydef est définie à TRUE si la définition de la requête peut être mis à jour, même si le jeu d'enregistrements qui en résulte n'est pas modifiable. Pour récupérer cette propriété directement, appelez la fonction membre CanUpdate de l'objet querydef. Pour plus d'informations, consultez la rubrique « Propriété actualisable » dans l'aide de DAO.

m_bReturnsRecords

Indique si une requête SQL directe à une base de données externe renvoie des enregistrements. Si cette propriété est TRUE, la requête retourne des enregistrements. Pour récupérer directement à cette propriété, appelez CDaoQueryDef::GetReturnsRecords. Pas toutes les requêtes SQL directes de SQL pour les bases de données externes renvoient des enregistrements. Par exemple, une instruction SQL UPDATE met à jour les enregistrements sans retourner les dossiers, alors qu'une instruction SQL SELECT retourne des enregistrements. Pour plus d'informations, consultez la rubrique « Propriété ReturnsRecords » dans l'aide de DAO.

m_strSQL

L'instruction SQL qui définit la requête exécutée par un objet querydef. La propriété SQL contient l'instruction SQL qui détermine comment enregistrements sont sélectionnés, groupés et ordonné lorsque vous exécutez la requête. Vous pouvez utiliser la requête pour sélectionner les enregistrements à inclure dans un objet recordset de type feuille de réponse dynamique ou instantané. Vous pouvez également définir des requêtes en vrac pour modifier les données sans retourner les documents. Vous pouvez récupérer la valeur de cette propriété directement en appelant la fonction de membre de l'objet querydef GetSQL . Pour plus d'informations, consultez l'article DAO requêtes dans le Guide du programmeur Visual C++ et la rubrique « Propriété SQL » dans l'aide de DAO.

m_strConnect

Fournit des informations sur la source d'une base de données utilisé dans une requête. Cette information prend la forme d'une chaîne de connexion. Pour plus d'information environ des chaînes de connexion et pour plus d'informations sur l'extraction directement de la valeur de cette propriété, consultez la fonction membre CDaoDatabase::GetConnect.

m_nODBCTimeout

Le nombre de secondes, que le moteur de base de données Microsoft Jet attend avant une erreur de dépassement de délai se produit lorsqu'une requête est exécutée sur une base de données ODBC. Lorsque vous utilisez une base de données ODBC, tels que Microsoft SQL Server, il existe peut-être des retards en raison de l'utilisation lourde ou de trafic de réseau du serveur ODBC. Plutôt que d'attendre indéfiniment, vous pouvez spécifier combien de temps le moteur Microsoft Jet attend avant qu'il produit une erreur. La valeur de 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 de membre GetODBCTimeout de l'objet querydef. Pour plus d'informations, consultez la rubrique « Propriété ODBCTimeout » dans l'aide de DAO.

Commentaires

Information récupérée par la fonction membre CDaoDatabase::GetQueryDefInfo est stockée dans une structure CDaoQueryDefInfo . Appelez GetQueryDefInfo pour l'objet de base de données dont la collection QueryDefs l'objet querydef est stockée. CDaoQueryDefInfo définit également une fonction membre Dump dans les versions de débogage. Vous pouvez utiliser Dump pour vider le contenu d'un objet CDaoQueryDefInfo . Classe CDaoDatabase fournit également des fonctions membres pour accéder directement à toutes les propriétés retournées dans un objet CDaoQueryDefInfo , donc vous devrez probablement rarement appel GetQueryDefInfo.

Lorsque vous ajouter un nouveau champ ou un objet parameter à la collection de champs ou des paramètres d'un objet querydef, une exception est levée si la base de données sous-jacent ne supporte pas le type de données spécifié pour l'objet nouveau.

Les paramètres de date et d'heure sont dérivées de l'ordinateur sur lequel l'objet querydef 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 à l'aide de la commande net time pour é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 aussi  ;CDaoQueryDef, CDaoDatabase