_QueryTable.Refresh(Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Updates einen externen Datenbereich (QueryTable). Boolean.

public bool Refresh (object BackgroundQuery);

Public Function Refresh (Optional BackgroundQuery As Object) As Boolean

Parameter

BackgroundQuery: Object

Optionales Objekt. 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 BackgroundQuery -Eigenschaft den Abfragemodus.

Gibt zurück

Boolean

Hinweise

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 False ist, werden keine Dialogfelder angezeigt, und die Refresh-Methode schlägt mit der Ausnahme Unzureichende Verbindungsinformationen fehl.

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. Sie können die abgeschlossene Verbindungszeichenfolge abrufen, indem Sie den Wert der Connection Eigenschaft untersuchen.

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. Wenn Parameter so festgelegt sind, dass sie zur Eingabe ihrer Werte aufgefordert werden, werden dem Benutzer Dialogfelder angezeigt, unabhängig von der Einstellung der DisplayAlerts Eigenschaft. 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 -Eigenschaft, um festzustellen, FetchedRowOverflow 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.

Gilt für:

Freigeben über