Connection.CreateQueryDef, méthode (DAO)
S’applique à : Access 2013, Office 2013
Crée un objet QueryDef.
Syntaxe
expression . CreateQueryDef(Name, SQLText)
expression Variable qui représente un objet Connection.
Paramètres
Nom |
Obligatoire/facultatif |
Type de données |
Description |
|---|---|---|---|
Name |
Facultatif |
Variant |
Variant (sous-type String) qui identifie par un nom unique le nouvel objet QueryDef. |
SQLText |
Facultatif |
Variant |
Variant (sous-type String) qui est une instruction SQL définissant la QueryDef. Si vous ne spécifiez pas cet argument, vous pouvez définir l'objet QueryDef en paramétrant sa propriété SQL avant ou après son ajout à une collection. |
Valeur renvoyée
QueryDef
Remarques
Dans un espace de travail Microsoft Access, si vous spécifiez autre chose qu’une chaîne de longueur nulle pour le nom lorsque vous créez un objet QueryDef, l’objet QueryDef résultant est automatiquement ajouté à la collection QueryDefs.
Si l’objet spécifié par le nom est déjà membre de la collection QueryDefs, une erreur d’exécution se produit. Vous pouvez créer un fichier temporaire QueryDef en utilisant une chaîne nulle pour l’argument nom lorsque vous exécutez la méthode CreateQueryDef. Vous obtenez un résultat identique en affectant à la propriété Name d'un nouvel objet QueryDef une chaîne nulle (""). Les objets QueryDef temporaires sont utiles si vous souhaitez utiliser à plusieurs reprises des instructions SQL dynamiques sans créer de nouveaux objets permanents dans la collection QueryDefs. Vous ne pouvez pas ajouter d'objet QueryDef temporaire à une collection car une chaîne nulle ne constitue pas un nom valide pour un objet QueryDef permanent. Vous avez toujours la possibilité de définir les propriétés Name et SQL du nouvel objet QueryDef et ajouter par la suite l'objet QueryDef à la collection QueryDefs.
Pour exécuter l’instruction SQL dans un objet QueryDef, utilisez la méthode Execute ou OpenRecordset.
Le recours à un objet QueryDef est la méthode généralement utilisée pour exécuter des requêtes SQL directes avec des bases de données ODBC.
Pour supprimer un objet QueryDef d'une collection QueryDefs dans une base de données de moteur de base de données Microsoft Access, appelez la méthode Delete sur la collection.