Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Exécute la requête et crée un jeu d’enregistrements 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 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.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 l’exécution. Si un gestionnaire est spécifié à l’aide de HandlerString, il peut modifier ou remplacer la chaîne de connexion.
HandlerString
La chaîne 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 de la chaîne contient des arguments à passer 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, il 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 qu’il est fortement 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 à partir 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
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 jeu d’enregistrements est créé à l’aide de adCmdTableDirect à l’aide 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.
Bien que ReadOnly, NoBatch et GetHiddenColumns sont des options mutuellement exclusives, il n’est pas une erreur de définir plusieurs d’entre eux. 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 jeu d’enregistrements est ouvert à l’aide de adLockBatchOptimistic mais les colonnes masquées ne sont pas incluses dans le jeu d’enregistrements.
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.
Remarques
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 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.
Remarque
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 super-ensemble des fonctionnalités fournies pour la même méthode dans ADO 2.1.