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

Article
11/08/2018

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 ensuite 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 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 le WCF Data Service.

Mot clé du fournisseur

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 le traitement. Ce mot clé équivaut à la RDS. Propriété Connect de l’objet DataControl.

Propriétés dynamiques

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

Nom de la 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 du 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 une fois qu’une connexion est établie. Il peut s’agir de l’une des valeurs de chaîne 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 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 du DataFactory sur le serveur. Vérifiez cette propriété pour voir si la version demandée dans la propriété DFMode a bien été respectée. Il peut s’agir de l’une des valeurs entières longues 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 requêtes paramétrables. - Obtention d’informations sur les paramètres ou les colonnes avant d’appeler la méthode Execute. - Définir les mises à jour de Transact sur Vrai. - Obtention de l’état de ligne. - Appel de la méthode resynchronisation. - Actualisation (explicitement ou automatique) via la propriété Update Resync. - Définition des propriétés de commande ou de jeu d'enregistrements . - Utilisation de adCmdTableDirect.
contrôleur	Indique le nom d’un programme de personnalisation côté serveur (ou gestionnaire) qui étend les fonctionnalités de la RDSServer.DataFactory, et tous les paramètres utilisés par le gestionnaire, tous séparés par des virgules (« , »). Valeur de string .
délai d’expiration Internet	Indique le nombre maximal de millisecondes à attendre pour qu’une demande se déplace 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 par cette connexion. Cette propriété équivaut à la propriété de l'objet RDS.DataContro Server.
des mises à jour Transact	Lorsqu’elle est définie sur True, cette valeur indique que lorsque updateBatch est effectuée sur le serveur, elle est effectuée à 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, en spécifiant la propriété dynamique , définissez le délai d'attente Internet sur cinq secondes :

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 du délai d’attente Internet propriété dynamique, puis définir une nouvelle valeur :

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

Remarques

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

L'équivalent de l'objet RDS.DataControlpropriété SQL n'est pas disponible. L’objet Recordsetméthode Openargument Source est utilisé à la place.

Remarque Le fait de spécifier « ... ; Remote Provider=MS Remote ; ... » créera un scénario à quatre niveaux. Les scénarios au-delà de trois niveaux n’ont pas été testés et ne doivent 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

Partage via