Vue d’ensemble du fournisseur de communication à distance Microsoft OLE DB

Le fournisseur de communication à distance Microsoft OLE DB permet à un utilisateur local sur un ordinateur client d’appeler des fournisseurs de données sur un ordinateur distant. Spécifiez les paramètres du fournisseur de données pour l’ordinateur distant comme vous le feriez si vous étiez un utilisateur local sur l’ordinateur distant. Spécifiez ensuite les paramètres utilisés par le fournisseur de communication à distance pour accéder à l’ordinateur distant. Vous pouvez alors accéder à l’ordinateur distant comme si vous étiez un utilisateur local.

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.

Mot clé Provider

Pour appeler le fournisseur de communication à distance OLE DB, spécifiez le mot clé et la valeur suivants dans la chaîne de connexion. (Notez l’espace vide dans le nom du fournisseur.)

"Provider=MS Remote"

Mots clés supplémentaires

Lorsque ce fournisseur de services est appelé, les mots clés supplémentaires suivants sont pertinents.

Mot clé	Description
Source de données	Spécifie le nom de la source de données distante. Il est transmis au fournisseur de communication à distance OLE DB pour traitement. Ce mot clé est équivalent à la propriété Connect de l’objet RDS.DataControl.

Propriétés dynamiques

Lorsque ce fournisseur de services est invoqué, les propriétés dynamiques suivantes sont ajoutées à la collection Properties de l’objet Connection.

Nom de propriété dynamique	Description
DFMode	Indique le mode DataFactory. Chaîne qui spécifie la version souhaitée de l’objet DataFactory sur le serveur. Définissez cette propriété avant d’ouvrir une connexion pour demander une version particulière de DataFactory. Si la version demandée n’est pas disponible, une tentative d’utilisation de la version précédente est effectuée. S’il n’existe aucune version précédente, une erreur se produit. Si DFMode est inférieur à la version disponible, une erreur se produit. Cette propriété est en lecture seule après l’établissement d’une connexion. Il peut s’agir de l’une des valeurs String valides suivantes : - « 25 » -Version 2.5 (par défaut) - "21"-Version 2.1 - "20"-Version 2.0 - "15"-Version 1.5
Propriétés de la commande	Indique les valeurs qui seront ajoutées à la chaîne de propriétés de commande (ensemble de lignes) envoyées au serveur par le fournisseur MS Remote. La valeur par défaut de cette chaîne est vt_empty.
DFMode actuel	Indique le numéro de version réel de DataFactory sur le serveur. Vérifiez cette propriété pour voir si la version demandée dans la propriété DFMode a été respectée. Il peut s’agir de l’une des valeurs entières Long valides suivantes : - 25 -Version 2.5 (par défaut) - 21-Version 2.1 - 20-Version 2.0 - 15-Version 1.5 L’ajout de « DFMode=20 ; » à votre chaîne de connexion lors de l’utilisation du fournisseur MSRemote peut améliorer les performances de votre serveur lors de la mise à jour des données. Avec ce paramètre, l’objet RDSServer.DataFactory sur le serveur utilise un mode moins gourmand en ressources. Toutefois, les fonctionnalités suivantes ne sont pas disponibles dans cette configuration : - Utilisation de paramètres paramétrables. - Obtention des informations de paramètre ou de colonne avant d’appeler la méthode Execute. - Définition Transact Updates sur True. - Obtention de l’état des lignes. - Appel de la méthode Resync. - Actualisation (explicitement ou automatiquement) via la propriété Update Resync. - Définition des propriétés d’un objet Command ou Recordset. - Utilisation de adCmdTableDirect.
Handler	Indique le nom d’un programme de personnalisation côté serveur (ou gestionnaire) qui étend les fonctionnalités de RDSServer.DataFactory et tous les paramètres utilisés par le gestionnaire, tous séparés par des virgules (« , »). Valeur de chaîne.
Dépassement du délai de connexion à Internet	Indique le nombre maximal de millisecondes à attendre pour qu’une requête transite vers et depuis le serveur. (La valeur par défaut est de 5 minutes.)
Fournisseur distant	Indique le nom du fournisseur de données à utiliser sur le serveur distant.
Serveur distant	Indique le nom du serveur et le protocole de communication à utiliser pour cette connexion. Cette propriété est équivalente à la propriété Server de l’objet RDS.DataControl.
Transact Updates	Lorsque la valeur est True, cette valeur indique que lorsque UpdateBatch est effectué sur le serveur, il est effectué à l’intérieur d’une transaction. La valeur par défaut de cette propriété dynamique booléenne est False.

Vous pouvez également définir des propriétés dynamiques accessibles en écriture en spécifiant leurs noms en tant que mots clés dans la chaîne de connexion. Par exemple, définissez la propriété dynamique Internet Timeout sur cinq secondes en spécifiant :

Dim cn as New ADODB.Connection
cn.Open "Provider=MS Remote;Internet Timeout=5000"

Vous pouvez également définir ou récupérer une propriété dynamique en spécifiant son nom comme index de la propriété Properties. L’exemple suivant montre comment obtenir et imprimer la valeur actuelle de la propriété dynamique Internet Timeout, puis définir une nouvelle valeur :

Debug.Print cn.Properties("Internet Timeout")
cn.Properties("Internet Timeout") = 5000

Notes

Dans ADO 2.0, le fournisseur de communication à distance OLE DB ne peut être spécifié que dans le paramètre ActiveConnection de la méthode Open de l’objet Recordset. À compter d’ADO 2.1, le fournisseur peut également être spécifié dans le paramètre ConnectionString de la méthode Open de l’objet Connection.

L’équivalent de la propriété SQL de l’objet RDS.DataControl n’est pas disponible. L’argument Source de la méthode Open de l’objet Recordset est utilisé à la place.

Remarque La spécification de « ...;Remote Provider=MS Remote;... » créerait un scénario à quatre niveaux. Les scénarios au-delà de trois niveaux n’ont pas été testés et ne devraient pas être nécessaires.

Exemple

Cet exemple exécute une requête sur la table Authors de la base de données Pubs sur un serveur nommé YourServer. Les noms de la source de données distante et du serveur distant sont fournis dans la méthode Open de l’objet Connection, et la requête SQL est spécifiée dans la méthode Open de l’objet Recordset. Un objet Recordset est retourné, modifié et utilisé pour mettre à jour la source de données.

Dim rs as New ADODB.Recordset
Dim cn as New ADODB.Connection
cn.Open  "Provider=MS Remote;Data Source=pubs;" & _
         "Remote Server=https://YourServer"
rs.Open "SELECT * FROM authors", cn
...                'Edit the recordset
rs.UpdateBatch     'Equivalent of RDS SubmitChanges
...

Voir aussi

Vue d’ensemble du fournisseur de communication à distance OLE DB