_QueryTable.Refresh(Object) Méthode

Définition

Met à jour une plage de données externe ( QueryTable ). Boolean.

public bool Refresh (object BackgroundQuery);
Public Function Refresh (Optional BackgroundQuery As Object) As Boolean

Paramètres

BackgroundQuery
Object

Objet facultatif. 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.

Retours

Boolean

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 Connection propriété. 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é a la valeur False, les boîtes de dialogue ne sont pas affichées et la méthode Refresh échoue avec DisplayAlerts l’exception Informations de 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 terminée en examinant la valeur de la Connection propriété.

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 requiert des paramètres, la collection doit être initialisée avec les informations de liaison de paramètre avant que la méthode Parameters Refresh ne soit appelée. Si le nombre de paramètres est incorrect, la méthode Refresh échoue (exception Erreur de paramètre). Si les paramètres sont paramétrables pour afficher leurs valeurs, les boîtes de dialogue s’affichent pour l’utilisateur, quel que soit le paramètre de la DisplayAlerts propriété. 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 récupérées dépasse le nombre de lignes disponibles dans la feuille de calcul, examinez la FetchedRowOverflow propriété. Cette propriété est initialisée à chaque appel de la méthode Refresh.

S’applique à