Execute21, méthode (RDS)
Exécute la requête et crée un Recordset ADO à utiliser dans ADO 2.1.
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.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)
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 identifiant 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 de la chaîne contient des arguments à transmettre au gestionnaire. La façon dont la chaîne d’arguments est interprétée est spécifique au gestionnaire. Les deux parties sont séparées par la première instance d’une virgule dans la chaîne (bien que la chaîne d’arguments puisse 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, elle 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.
En outre, si un gestionnaire est utilisé (et il est vivement recommandé d’utiliser un gestionnaire), 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é.
lMarshalOptions
Permet de définir les options de marshaling sur l’ensemble de lignes/recordset retourné.
TableID
Une variante 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 de adCmdTableDirect en utilisant 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 de 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 de adLockBatchOptimistic et toutes les colonnes masquées seront incluses dans le recordset.
Bien que ReadOnly, NoBatch et GetHiddenColumns soient des options mutuellement exclusives, le fait de 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 options, suivie de ReadOnly. Si aucune option n’est spécifiée, par défaut, le recordset est ouvert à l’aide de adLockBatchOptimistic mais les colonnes masquées ne sont pas incluses dans le recordset.
pParameters
Variante 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.
Notes
Le paramètre HandlerString peut être null. Ce qui se produit 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.
Notes
La méthode Execute21 est une version de la méthode Execute (RDS). Lorsque vous devez utiliser la méthode Execute pour communiquer avec ADO 2.1, la méthode Execute21 peut être appelée à la place. Les fonctionnalités de la méthode Execute dans ADO 2.5 et ultérieures sont un superensemble des fonctionnalités fournies pour la même méthode dans ADO 2.1.