Méthode QueryTable.Refresh (Excel)

  • Article

Mises à jour une plage de données externe dans un objet QueryTable.

Syntaxe

expression. Actualiser (BackgroundQuery)

Expression Variable qui représente un objet QueryTable .

Parameters

Nom Requis/Facultatif Type de données Description
BackgroundQuery Facultatif Variant S’utilise uniquement avec les objets QueryTables qui sont fondés sur les résultats d’une requête SQL. True pour redonner le contrôle à la procédure dès qu’une connexion de base de données est établie et la requête envoyée. L'objet QueryTable est mis à jour en arrière-plan. False pour ne redonner le contrôle à la procédure qu'une fois que toutes les données ont été récupérées dans la feuille de calcul.

Si cet argument n’est pas spécifié, le paramètre de la propriétéBackgroundQuery détermine le mode de requête.

Valeur renvoyée

Booléen

Remarques

Les notes suivantes s’appliquent aux objets QueryTable reposant sur les résultats d’une requête SQL.

La méthode Refresh connecte Microsoft Excel à la source de données de l’objet QueryTable, exécute la requête SQL et renvoie les données à la plage reposant sur l’objet QueryTable. Tant que cette méthode n’est pas appelée, l’objet QueryTable ne communique pas avec la source de données.

Lors de la connexion à la source de données OLE DB ou ODBC, Microsoft Excel utilise la chaîne de connexion spécifiée par la propriété Connection . Si la chaîne de connexion spécifiée ne contient pas les valeurs requises, des boîtes de dialogue s'affichent pour demander les informations nécessaires à l'utilisateur. Si la propriété DisplayAlerts a la valeur False, ces boîtes de dialogue ne s'affichent pas et la méthode Refresh échoue, avec l'exception Informations pour la connexion insuffisantes.

Dès que Microsoft Excel a réussi à établir une connexion, il stocke la chaîne de connexion complète de sorte que les messages ne s’affichent pas pour les appels suivants à la méthode Refresh pendant la même session de travail. Vous pouvez obtenir la chaîne de connexion entière en examinant la valeur de la propriété Connection.

Une fois que la connexion à la base de données est établie, la requête SQL est validée. Si la requête n’est pas valide, la méthode Refresh échoue (exception Erreur de syntaxe SQL).

Si la requête nécessite des paramètres, la collection Parameters doit être initialisée avec des informations de liaison de paramètre avant l’appel de la méthode Refresh . Si le nombre de paramètres est incorrect, la méthode Refresh échoue (exception Erreur de paramètre). Si les paramètres sont configurés pour une saisie interactive des valeurs, des boîtes de dialogue s'affichent, quelle que soit la valeur affectée à la propriété DisplayAlerts. Dans le cas où l'utilisateur annule une boîte de dialogue de paramètre, la méthode Refresh s'interrompt et renvoie False. Les paramètres supplémentaires liés à la collection Parameters sont ignorés.

La méthode Refresh renvoie True si la requête est exécutée ou lancée correctement, et elle renvoie False si l’utilisateur annule une connexion ou une boîte de dialogue de paramètre.

Pour voir si le nombre de lignes extraites dépasse le nombre de lignes disponibles dans la feuille de calcul, examinez la propriété FetchedRowOverflow . Cette propriété est initialisée à chaque appel de la méthode Refresh.

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.