Méthode WorkbookConnection.Refresh (Excel)

Actualise la connexion d’un classeur.

Syntaxe

expression. Actualiser

expression Variable qui représente un objet WorkbookConnection .

Remarques

Si la propriété DisplayAlerts a la valeur False, les boîtes de dialogue ne s’affichent pas et la méthode d’actualisation échoue avec l’exception « Informations de connexion insuffisantes ».

Un échec d’actualisation pour une connexion n’aura aucun impact sur les opérations d’actualisation pour les autres connexions.

Si la connexion charge une requête créée avec Power Query dans une table de feuille de calcul, l’actualisation en arrière-plan est désactivée pour la connexion (la propriété BackgroundQuery de son objet OLEDBConnection est False) et la requête dans son ensemble ne parvient pas à évaluer (par exemple, en raison d’une error expression dans une étape, ou d’une fonction de ce typeNumber.FromText, qui échoue alors que la valeur d’une étape est calculée plutôt qu’à l’intérieur d’une seule cellule), la méthode Refresh lève l’erreur d’exécution 1004 avec une description générique (« Erreur définie par l’application ou l’objet »). Le message d’erreur généré par la requête n’est pas inclus. Pour obtenir le message d’erreur de la requête, actualisez la table à l’aide de la méthode Refresh de son objet QueryTable avec l’actualisation en arrière-plan désactivée à la place. Cette méthode génère le même numéro d’erreur et sa description inclut l’erreur de la requête, par exemple [Expression.Error] ....

Si l’actualisation en arrière-plan est activée, la méthode d’actualisation est renvoyée avant la fin de l’actualisation et les erreurs qui se produisent pendant l’actualisation ne sont pas renvoyées au code appelant.

Les erreurs dans chaque cellule du résultat de la requête n’entraînent pas l’échec de l’actualisation. L’actualisation réussit et ces cellules restent vides.

Exemple

Cet exemple actualise chaque table de requête de la feuille active et écrit le message d’erreur de chaque échec d’actualisation dans la fenêtre Exécution. L’appel d’actualisation sur les objets WorkbookConnection signalerait uniquement la description générique.

Sub RefreshQueryTables()
    Dim lo As ListObject
    For Each lo In ActiveSheet.ListObjects
        If lo.SourceType = xlSrcQuery Then
            On Error Resume Next
            ' lo.QueryTable.WorkbookConnection.Refresh would report only a generic description.
            lo.QueryTable.Refresh BackgroundQuery:=False
            If Err.Number <> 0 Then Debug.Print lo.Name & ": " & Err.Description
            On Error GoTo 0
        End If
    Next lo
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.