MoveRecord-Methode (ADO)
Gilt für: Access 2013, Office 2013
Verschiebt die durch einen Record dargestellte Entität an einen anderen Speicherort.
Syntax
Datensatz. MoveRecord (Quelle, Ziel, Benutzername, Kennwort, Optionen, Async)
Parameter
| Parameter | Beschreibung |
|---|---|
| Source | Optional. Ein String-Wert mit einer URL, die den zu verschiebenden Record identifiziert. Wenn Source nicht angegeben ist oder eine leere Zeichenfolge angibt, wird das durch diesen Record dargestellte Objekt verschoben. Stellt Record beispielsweise eine Datei dar, wird der Inhalt der Datei an den durch Destination angegebenen Speicherort verschoben. |
| Ziel | Optional. Ein String-Wert mit einer URL, die den Speicherort angibt, an den Source verschoben wird. |
| UserName | Optional. Ein String-Wert mit der Benutzer-ID, die bei Bedarf Zugriff auf die Destination gewährt. |
| Password | Optional. Ein String-Wert, der das Kennwort enthält, das bei Bedarf den UserName bestätigt. |
| Optionen | Optional. Ein MoveRecordOptionsEnum-Wert, dessen Standardwert adMoveUnspecified lautet. Gibt das Verhalten dieser Methode an. |
| Async | Optional. Ein boolescher Wert, der bei True angibt, dass dieser Vorgang asynchron sein soll. |
Rückgabewert
Ein String-Wert. In der Regel wird der Wert für Destination zurückgegeben. Der genaue Wert, der zurückgegeben wird, ist jedoch vom Anbieter abhängig.
Hinweise
Die Werte für Source und Destination dürfen nicht identisch sein, andernfalls tritt ein Laufzeitfehler auf. Mindestens der Server-, Pfad- und Ressourcenname müssen unterschiedlich sein.
Bei Dateien, die mithilfe des Internet Publishing-Anbieters verschoben wurden, aktualisiert diese Methode alle Hypertextlinks in Dateien, die verschoben werden, sofern nicht anders in Den Optionen angegeben. Diese Methode schlägt fehl, wenn Destination ein vorhandenes Objekt (z. B. eine Datei oder ein Verzeichnis) identifiziert, es sei denn , adMoveOverWrite ist angegeben.
Hinweis
Verwenden Sie die Option adMoveOverWrite nur nach sorgfältiger Überlegung. Wenn Sie diese Option beispielsweise beim Verschieben einer Datei in ein Verzeichnis angeben, wird das Verzeichnis gelöscht und durch die Datei ersetzt.
Bestimmte Attribute des Record-Objekts (z. B. die ParentURL-Eigenschaft) werden nicht aktualisiert, nachdem dieser Vorgang abgeschlossen ist. Aktualisieren Sie die Eigenschaften des Record-Objekts, indem Sie den Record schließen und anschließend mit der URL des Speicherorts, an den die Datei oder das Verzeichnis verschoben wurde, erneut öffnen.
Wurde dieser Record aus einem Recordset-Objekt abgerufen, wird der neue Speicherort der verschobenen Datei oder des verschobenen Verzeichnisses nicht unmittelbar im Recordset -Objekt wiedergegeben. Aktualisieren Sie das Recordset-Objekt, indem Sie es schließen und erneut öffnen.
Hinweis
Bei URLs, die das HTTP-Schema verwenden, wird automatisch der Microsoft OLE DB-Anbieter für Internet Publishing aufgerufen. Weitere Informationen finden Sie unter Absolute und relative URLs.