Refresh-Methode (ADO)

Artikel
05/30/2023

Aktualisiert die Objekte in einer Sammlung, um die Objekte darzustellen, die von dem Anbieter verfügbar und für diesen spezifisch sind

Syntax

  
collection.Refresh

Bemerkungen

Die Refresh-Methode führt unterschiedliche Aufgaben abhängig von der Sammlung aus, von der aus Sie sie aufrufen.

Parameter

Durch das Verwenden der Refresh-Methode für die Parameters-Sammlung eines Command-Objekts werden anbieterseitige Parameterinformationen für die gespeicherte Prozedur oder die parametrisierte Abfrage abgerufen, die im Command-Objekt angegeben ist. Die Sammlung ist für Anbieter leer, die gespeicherte Prozeduraufrufe oder parametrisierte Abfragen nicht unterstützen.

Sie sollten die ActiveConnection-Eigenschaft des Command-Objekts auf ein gültiges Connection-Objekt, die CommandText-Eigenschaft auf einen gültigen Befehl und die CommandType-Eigenschaft auf adCmdStoredProc festlegen, bevor Sie die Refresh-Methode aufrufen.

Wenn Sie auf die Parameters-Sammlung zugreifen, bevor Sie die Refresh-Methode aufrufen, ruft ADO automatisch die Methode auf und füllt die Sammlung für Sie auf.

Hinweis

Wenn Sie die Refresh-Methode zum Abrufen von Parameterinformationen vom Anbieter verwenden und sie einen oder mehrere Parameter-Objekte mit Datentypen variabler Länge zurückgibt, ordnet ADO Arbeitsspeicher für die Parameter eventuell basierend auf ihrer maximalen potenziellen Größe zu, was während der Ausführung zu einem Fehler führen kann. Um Fehler zu verhindern, sollten Sie die Size-Eigenschaft für diese Parameter explizit festlegen, bevor Sie die Execute-Methode aufrufen.

Felder

Das Verwenden der Refresh-Methode in der Fields-Sammlung hat keinen sichtbaren Effekt. Um Änderungen aus der zugrunde liegenden Datenbankstruktur abzurufen, müssen Sie entweder die Methode Requery verwenden oder, sofern das Recordset-Objekt keine Textmarken unterstützt, die Methode MoveFirst.

Eigenschaften

Das Verwenden der Refresh-Methode in einer Properties-Sammlung einiger Objekte füllt die Sammlung mit den dynamischen Eigenschaften auf, die der Anbieter verfügbar macht. Diese Eigenschaften bieten Informationen zu anbieterspezifischen Funktionen, die über die von ADO unterstützten integrierten Eigenschaften hinausgehen.