Partager via

Objet DataRecordset (Visio)

  • Article

Stocke, met en forme, actualise et expose dans Microsoft Visio les données qui ont fait l’objet d’une requête dans une base de données.

Remarque

Cet objet ou ce membre Visio est disponible uniquement pour les titulaires d’une licence d’utilisation de Visio Professionnel 2013.

Remarques

Microsoft Visio peut se connecter aux données de plusieurs sources, notamment :

  • Feuilles de calcul Excel
  • Bases de données Access
  • Bases de données SQL Server
  • Listes SharePoint
  • autres sources de données OLEDB/ODBC, telles que des bases de données Oracle ;
  • Fichiers XML qui adhèrent au schéma XML classique ADO

Chaque objet Document Visio a une collection DataRecordsets , qui est vide jusqu’à ce qu’une connexion à une source de données soit établie. Pour connecter un document Visio à une source de données, vous devez ajouter un objet DataRecordset à la collection DataRecordsets du document.

Pour ajouter un objet DataRecordset à la collection DataRecordsets , vous pouvez utiliser l’une des trois méthodes suivantes, en fonction du type de source de données à laquelle vous souhaitez vous connecter (OLEDB/ODBC ou XML) et de la façon dont vous souhaitez passer des chaînes de connexion et des chaînes de commande de requête à Visio. À l’aide de :

  • DataRecordsets.Add , vous pouvez vous connecter à une source de données OLEDB ou ODBC et transmettre des informations de chaîne de commande de connexion et de requête à Visio directement en tant que paramètres de méthode.

  • Méthode DataRecordsets.AddFromConnectionFile , vous pouvez vous connecter à une source de données OLEBD ou ODBC en transmettant à la méthode un fichier ODC (Office Data Connection) qui contient les informations de connexion et de chaîne de commande de requête que vous souhaitez fournir à Visio.

  • DataRecordsets.AddFromXML , vous transmettez à la méthode une chaîne XML classique ADO qui contient toutes les données que vous souhaitez inclure dans le jeu d’enregistrements de données.

Une fois que vous avez créé un jeu d’enregistrements de données, la chaîne de connexion et la chaîne de commande de requête associée au jeu d’enregistrements de données sont représentées respectivement par les propriétés DataConnection.ConnectionString et CommandString .

Si le jeu d’enregistrements de données est associé à un objet DataConnection , c’est-à-dire si vous l’avez ajouté à la collection DataRecordsets à l’aide de la méthode Add ou AddFromConnectionFile , vous pouvez utiliser la propriété DataConnection pour obtenir l’objet DataConnection associé.

La propriété par défaut d’un objet DataRecordset est ID. La valeur de la propriété ID identifie le DataRecordset dans la collection DataRecordsets et est unique dans la collection pour un document donné.

Utilisez la propriété Name pour associer un nom d’affichage au jeu d’enregistrements de données.

Utilisez la méthode GetDataRowIDs pour obtenir un tableau des ID de toutes les lignes d’un jeu d’enregistrements de données, où chaque ligne représente un enregistrement de données unique. Une fois que vous avez récupéré les ID de ligne de données de cette manière, vous pouvez utiliser la méthode GetRowData pour obtenir toutes les données stockées dans chaque colonne de la ligne de données.

Utilisez la propriété DataColumns pour obtenir l’objet DataColumn associé au jeu d’enregistrements de données. L’objet DataColumn expose les méthodes et les propriétés qui vous permettent de personnaliser le mappage des colonnes de données sur les cellules de la section Données de forme de la feuille de calcul ShapeSheet pour les formes liées aux données.

Définir une colonne de clé primaire pour un jeu d’enregistrements de données permet d’éviter toute rupture de liens entre des formes et des données lors de l’actualisation des données. Vous pouvez récupérer la colonne de clé primaire et la définir en utilisant respectivement les méthodes GetPrimaryKey et SetPrimaryKey.

Lorsque des données sont modifiées dans la source de données, vous pouvez actualiser les données d’un jeu d’enregistrements de données (non XML) connecté pour refléter ces modifications. Vous pouvez spécifier une actualisation automatique des données par Visio à un intervalle régulier en définissant la propriété RefreshInterval ou vous pouvez actualiser les données par programme en appelant la méthode Refresh.

Des conflits peuvent se produire lorsque vous actualisez des données d'une source de données qui a été modifiée depuis la dernière actualisation de données. Des conflits peuvent se produire lorsqu’une seule forme est liée à plusieurs lignes dans la même source de données, ou lorsqu’une forme est liée à une ligne de la source de données qui a été supprimée. Vous pouvez découvrir et résoudre les conflits qui proviennent de l’actualisation des données à l’aide des méthodes GetAllRefreshConflicts, GetMatchingRowsForRefreshConflict et RemoveRefreshConflict .

Remarque

Lorsque vous enregistrez un document Visio qui contient un ou plusieurs jeux d'enregistrements de données, toutes les données contenues dans ces derniers sont enregistrées dans le fichier Visio. Si des jeux d'enregistrements de données contiennent de grande quantité de données, les fichiers Visio générés peuvent être très volumineux. Vous devez par conséquent filtrer les sources de données volumineuses avant de les importer dans Visio.

Événements

Méthodes

Propriétés

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.