Présentation de Microsoft Data Shaping Service pour OLE DB

Important

Cette fonctionnalité sera supprimée dans une version future 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 doivent plutôt utiliser XML.

Le fournisseur de services de mise en forme des données Microsoft pour OLE DB prend en charge la construction d’objets Recordset hiérarchiques (mis en forme) d’un fournisseur de données.

Mot clé Provider

Pour appeler le service de mise en forme des données pour OLE DB, spécifiez le mot clé et la valeur suivants dans la chaîne de connexion.

"Provider=MSDataShape"

Propriétés dynamiques

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

Nom de propriété dynamique	Description
Noms de remodelage uniques	Indique si les objets Recordset avec des valeurs en double pour leurs propriétés Reshape Name sont autorisés. Si cette propriété dynamique a la valeur True et qu’un nouvel objet Recordset est créé avec le même nom de remodelage spécifié par l’utilisateur qu’un Recordset existant, le nouveau nom de remodelage de l’objet Recordset est modifié pour le rendre unique. Si cette propriété a la valeur False et qu’un objet Recordset est créé avec le même nom de remodelage spécifié par l’utilisateur que l’objet Recordset existant, les deux objets Recordset auront le même nom de remodelage. Par conséquent, aucun Recordset ne peut être remodelé tant que les deux objets Recordset existent. La valeur par défaut de la propriété est False.
Fournisseur de données	Indique le nom du fournisseur qui fournira les lignes à mettre en forme. Cette valeur peut être NONE si un fournisseur ne sera pas utilisé pour fournir des lignes.

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, dans Microsoft Visual Basic, définissez la propriété dynamique Data Provider sur « MSDASQL » en spécifiant :

Dim cn as New ADODB.Connection
cn.Open "Provider=MSDataShape;Data Provider=MSDASQL"

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. Par exemple, l’exemple de code suivant obtient et imprime la valeur actuelle de la propriété dynamique Data Provider, puis définit une nouvelle valeur si cn.DataProvider a été défini sur « MSDataShape » (directement ou indirectement via la chaîne de connexion) et que la connexion n’a pas été ouverte :

Debug.Print cn.Properties("Data Provider")
cn.Properties("Data Provider") = "MSDASQL"

Remarque

La propriété dynamique, Fournisseur de données, ne peut être définie que sur un objet Connection non ouvert. Une fois la connexion ouverte, la propriété Data Provider passe en lecture seule.

Pour plus d’informations sur la mise en forme des données, consultez Mise en forme des données.

Voir aussi

Annexe A : Fournisseurs