Execute, méthode (RDS)
Exécute la requête et crée un Recordset ADO à utiliser dans ADO 2.5 et versions ultérieures.
Important
À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.
Syntaxe
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])
Paramètres
ConnectionString
Chaîne utilisée pour se connecter au fournisseur OLE DB où la requête sera envoyée pour exécution. Si un gestionnaire est spécifié à l’aide de HandlerString, il peut modifier ou remplacer la chaîne de connexion.
HandlerString
Chaîne en deux parties qui identifie le gestionnaire à utiliser avec cette exécution. La chaîne de caractères contient deux parties. La première partie contient le nom (ProgID) du gestionnaire à utiliser. La deuxième partie contient des arguments à transmettre au gestionnaire. Les détails de la façon dont la chaîne d’arguments est interprétée sont spécifiques à chaque gestionnaire. Les deux parties sont séparées par la première instance d’une virgule dans la chaîne. La chaîne d’arguments peut contenir des virgules supplémentaires. Les arguments sont facultatifs.
QueryString
Commande dans le langage de commande pris en charge par le fournisseur OLE DB identifié dans la chaîne de connexion. Pour les fournisseurs SQL, QueryString peut contenir une instruction de commande Transact-SQL, mais pour les fournisseurs non-SQL (par exemple, MSDataShape) il peut ne pas s’agir d’une instruction de requête Transact-SQL.
Si un gestionnaire est utilisé, le gestionnaire peut modifier ou remplacer la valeur spécifiée ici. Par exemple, le gestionnaire remplace généralement QueryString par une chaîne de requête de son fichier .ini. Par défaut, le fichier Msdfmap.ini est utilisé.
lFetchOptions
Indique le type d’extraction asynchrone.
Pour plus d’informations, consultez FetchOptions, propriété (RDS).
TableID
Un Variant de type VT_EMPTY ou VT_BSTR. Si cette valeur est de type VT_EMPTY, elle est ignorée. S’il s’agit d’un type VT_BSTR, le recordset est créé à l’aide d’adCmdTableDirect et de la valeur spécifiée ici, et le paramètre QueryString est ignoré.
lExecuteOptions
Masque de bits des options d’exécution :
1=ReadOnly Le recordset est ouvert à l’aide d’adLockReadOnly.
2=NoBatch Le recordset est ouvert à l’aide d’adLockOptimistic.
4=AllParamInfoSupplied L’appelant garantit que les informations de paramètre pour tous les paramètres sont fournies dans pParameters.
8=GetInfo Les informations sur les paramètres de la requête seront obtenues auprès du fournisseur OLE DB et renvoyées dans le paramètre pParameters. La requête n’est pas exécutée et aucun recordset n’est retourné.
16=GetHiddenColumns Le recordset est ouvert à l’aide d’adLockBatchOptimistic et toutes les colonnes masquées seront incluses dans le recordset.
ReadOnly, NoBatch et GetHiddenColumns sont des options mutuellement exclusives ; toutefois, définir plusieurs d’elles ne génère pas d’erreur. Si plusieurs options sont définies, GetHiddenColumns est prioritaire sur toutes les autres, suivie de ReadOnly. Si aucune option n’est spécifiée, par défaut, le recordset est ouvert à l’aide d’adLockBatchOptimistic et les colonnes masquées ne sont pas incluses dans le recordset.
pParameters
Un Variant qui contient un tableau sécurisé de définitions de paramètres. Si l’option GetInfo a été spécifiée dans lExecuteOptions, ce paramètre est utilisé pour renvoyer les définitions de paramètres obtenues à partir du fournisseur OLE DB. Sinon, ce paramètre peut être vide.
lcid
LCID utilisé pour générer toutes les erreurs retournées dans pInformation.
pInformation
Pointeur vers une erreur d’information retournée par Execute. Si NULL, aucune information d’erreur n’est retournée.
Notes
Le paramètre HandlerString peut être null. Ce qui se passe dans ce cas dépend de la façon dont le serveur RDS est configuré. Une chaîne de gestionnaire « MSDFMAP.handler » indique que le gestionnaire fourni par Microsoft (Msdfmap.dll) doit être utilisé. Une chaîne de gestionnaire « MASDFMAP.handler,sample.ini » indique que le gestionnaire Msdfmap.dll doit être utilisé et que l’argument « sample.ini » doit être transmis au gestionnaire. MSDFMAP.dll interprétera l’argument comme une instruction d’utiliser sample.ini pour vérifier les chaînes de connexion et de requête.