Execute, méthode (RDS)
Exécute la requête et crée un jeu d’enregistrements 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 Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail 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 l’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 contient deux parties. La première partie contient le nom (ProgID) du gestionnaire à utiliser. La deuxième partie contient des arguments à passer 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), cela peut ne pas être 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 à partir 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
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 jeu d’enregistrements est créé à l’aide de 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 jeu d’enregistrements sera ouvert à l’aide de adLockReadOnly.
2=NoBatch Le jeu d’enregistrements sera ouvert à l’aide de adLockOptimistic .
4=AllParamInfoSupplied L’appelant garantit que les informations de paramètre pour tous les paramètres sont fournies dans pParameters.
8=Informations sur le paramètre GetInfo pour la requête seront obtenues auprès du fournisseur OLE DB et retournées dans le paramètre pParameters. La requête n’est pas exécutée et aucun jeu d’enregistrements n’est retourné.
16=GetHiddenColumns Le jeu d’enregistrements sera ouvert à l’aide de adLockBatchOptimistic et toutes les colonnes masquées seront incluses dans le jeu d’enregistrements.
ReadOnly, NoBatch et GetHiddenColumns s’excluent mutuellement ; toutefois, il ne génère pas d’erreur pour définir plusieurs d’entre eux. 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 jeu d’enregistrements est ouvert à l’aide de adLockBatchOptimistic et les colonnes masquées ne sont pas incluses dans le jeu d’enregistrements.
pParameters
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 les erreurs retournées dans pInformation .
pInformation
Pointeur vers une erreur d’information retournée par Execute. Si la valeur EST NULL, aucune information d’erreur n’est retournée.
Remarques
Le paramètre HandlerString peut être null. Ce qui se passe dans ce cas dépend de la configuration du serveur RDS. Une chaîne de gestionnaire de « 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 passé au gestionnaire. MSDFMAP.dll interprétera l’argument comme une direction pour utiliser la sample.ini pour vérifier la connexion et les chaînes de requête.