DataRecordset.Refresh, méthode (Visio)

Article
04/07/2023

Exécute la chaîne de requête associée au DataRecordset connecté (non basé sur XML) et met à jour les formes liées avec les nouvelles données de la source de données retournées par la requête.

Remarque

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

Syntaxe

expression. Actualiser

Expression Expression qui renvoie un objet DataRecordset .

Valeur renvoyée

Aucune

Remarques

L’appel de la méthode Refresh sur un objet DataRecordset particulier entraîne l’actualisation de tous les autres objets DataRecordset associés au même objet DataConnection (autrement dit, ayant la même valeur pour leur propriété DataConnection ). Les objets DataRecordset partageant la même valeur de propriété DataConnection sont appelés jeux d’enregistrements de données traités. La méthode Refresh doit être appelée sur un jeu d’enregistrements de données associé à un objet DataConnection .

Si vous appelez Refresh sur un jeu d’enregistrements de données non associé à un objet DataConnection (créé à l’aide de la méthode DataRecordsets.AddFromXML ), la méthode Refresh renvoie une erreur.

Si l’appel de la méthode Refresh génère des conflits, Visio affiche le volet Office Actualiser les conflits dans l’interface utilisateur, à moins que vous n’ayez défini la propriété DataRecordset.RefreshSettings de sorte qu’elle contienne la valeur énumérée visRefreshNoReconciliationUI.

Avant d’actualiser les données liées, si vous souhaitez modifier la chaîne de requête utilisée par Visio pour récupérer les données afin d’interroger une autre table dans la même base de données, définissez la propriété DataRecordset.CommandString sur une nouvelle valeur. Pour vous connecter à une source de données entièrement nouvelle, définissez les valeurs des propriétés DataRecordset.CommandString et DataConnection.ConnectionString .

Quand vous actualisez des données et qu’un conflit se produit, vous pouvez utiliser les méthodes DataRecordset.GetAllRefreshConflicts et DataRecordset.GetMatchingRowsForRefreshConflict pour déterminer la raison du conflit.

Exemple

Cette macro Microsoft Visual Basic pour Applications (VBA) illustre comment utiliser la méthode Refresh pour actualiser les données dans un objet DataRecordset de la collection DataRecordsets du document actif. Elle récupère le nombre des jeux d'enregistrements des données associés au document actif, puis actualise le jeu qui a été dernièrement ajouté. Elle actualise également les jeux d'enregistrements de données associés au document actifs qui partagent une connexion de données commune avec le jeu actualisé.

Avant d'exécuter cette macro, vérifiez que le document actif contient au moins un jeu d'enregistrements de données et que le jeu d'enregistrements de données dernièrement ajouté est connecté (non XML).

Public Sub Refresh_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
 
    intCount = ThisDocument.DataRecordsets.Count 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.Refresh 
 
End Sub

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.

Partager via