QueryTable.Refresh-Methode (Excel)

Aktualisierungen einen externen Datenbereich in einem QueryTable-Objekt.

Syntax

Ausdruck. Refresh (BackgroundQuery)

Ausdruck Eine Variable, die ein QueryTable-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
BackgroundQuery	Optional	Variant	Wird nur für QueryTables-Objekte verwendet, die auf den Ergebnissen einer SQL-Abfrage basieren. Mit True wird die Steuerung wieder an die Prozedur zurückgegeben, sobald die Datenbankverbindung hergestellt ist und die Abfrage gestartet wurde. Das QueryTable -Objekt wird im Hintergrund aktualisiert. Mit False wird die Steuerung erst wieder an die Prozedur zurückgegeben, nachdem alle Daten aus dem Arbeitsblatt abgerufen wurden. Wenn dieses Argument nicht angegeben wird, bestimmt die Einstellung der Eigenschaft BackgroundQuery den Abfragemodus.

Rückgabewert

Boolesch

Bemerkungen

Die folgenden Anmerkungen gelten für QueryTable-Objekte, die auf den Ergebnissen einer SQL-Abfrage basieren.

Durch die RefreshRefresh-Methode wird Microsoft Excel mit der Datenquelle des QueryTable-Objekts verbunden, führt die SQL-Abfrage aus und gibt die Daten an den Bereich zurück, der auf dem QueryTable-Objekt basiert. Bis diese Methode aufgerufen wird, kommuniziert das QueryTable-Objekt nicht mit der Datenquelle.

Beim Herstellen der Verbindung mit der OLE DB- oder ODBC-Datenquelle verwendet Microsoft Excel die von der Connection-Eigenschaft angegebene Verbindungszeichenfolge. Fehlen in der angegebenen Verbindungszeichenfolge erforderliche Werte, werden Dialogfelder angezeigt, in denen der Benutzer zur Eingabe der benötigten Daten aufgefordert wird. Wenn die DisplayAlerts -Eigenschaft den Wert False aufweist, werden keine Dialogfelder angezeigt, und die Refresh -Methode bricht mit dem Ausnahmefehler "Ungenügende Informationen zur Verbindung" ab.

Nach dem erfolgreichen Verbindungsaufbau wird die vervollständigte Verbindungszeichenfolge in Microsoft Excel gespeichert, sodass während dieser Bearbeitungssitzung bei erneuten Aufrufen der Refresh-Methode keine weiteren Eingabeaufforderungen angezeigt werden. Die vervollständigte Verbindungszeichenfolge erhalten Sie, wenn Sie den Wert der Connection -Eigenschaft prüfen.

Nach dem Aufbau der Datenbankverbindung wird die SQL-Abfrage überprüft. Ist sie nicht richtig, so bricht die RefreshRefresh-Methode mit dem Ausnahmefehler "SQL-Syntax-Fehler" ab.

Wenn die Abfrage Parameter erfordert, muss die Parameters-Auflistung mit Parameterbindungsinformationen initialisiert werden, bevor die Refresh-Methode aufgerufen wird. Sind nicht genügend Parameter gebunden, bricht die Refresh -Methode mit dem Ausnahmefehler "Parameterfehler" ab. Wurde festgelegt, dass Parameter ihre Werte anfordern, werden dem Benutzer unabhängig von den Einstellungen der DisplayAlerts -Eigenschaft Dialogfelder angezeigt. Bricht der Benutzer ein Parameterdialogfeld ab, wird die Refresh -Methode nicht erfolgreich ausgeführt und der Wert False zurückgegeben. Sind an die Parameters -Auflistung zusätzliche Parameter gebunden, werden diese ignoriert.

Die Refresh-Methode gibt den Wert True zurück, wenn die Abfrage erfolgreich abgeschlossen oder begonnen wird; sie gibt den Wert False zurück, wenn der Benutzer eine Verbindung abbricht oder ein Parameterdialogfeld schließt.

Überprüfen Sie die FetchedRowOverflow-Eigenschaft , um festzustellen, ob die Anzahl der abgerufenen Zeilen die Anzahl der verfügbaren Zeilen auf dem Arbeitsblatt überschritten hat. Diese Eigenschaft wird bei jedem Aufruf der Refresh -Methode initialisiert.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.