MoveRecord-Methode (ADO)
Verschiebt die durch einen Record dargestellte Entität an einen anderen Speicherort.
Syntax
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parameter
Source-
Wahlfrei. Ein String--Wert, der eine URL enthält, die den zu verschiebenden Record- identifiziert. Wenn Source- weggelassen wird oder eine leere Zeichenfolge angibt, wird das durch dieses Record dargestellte Objekt verschoben. Wenn beispielsweise der Record eine Datei darstellt, werden die Inhalte der Datei an den speicherort verschoben, der durch Destinationangegeben wird.
Ziel-
Wahlfrei. Ein String--Wert, der eine URL enthält, die den Speicherort angibt, an den Source verschoben wird.
UserName-
Wahlfrei. Ein String Wert, der die Benutzer-ID enthält, die bei Bedarf den Zugriff auf Ziel-autorisiert.
Kennwort
Wahlfrei. Eine Zeichenfolge, die das Kennwort enthält, das bei Bedarf UserNameüberprüft.
Optionen
Wahlfrei. Ein MoveRecordOptionsEnum Wert, dessen Standardwert adMoveUnspecifiedist. Gibt das Verhalten dieser Methode an.
Async-
Wahlfrei. Ein boolescher Wert, der, wenn True, angibt, dass dieser Vorgang asynchron sein soll.
Rückgabewert
Ein String--Wert. In der Regel wird der Wert Ziel- zurückgegeben. Der zurückgegebene genaue Wert ist jedoch vom Anbieter abhängig.
Bemerkungen
Die Werte der Source und Destination dürfen nicht identisch sein; andernfalls tritt ein Laufzeitfehler auf. Mindestens die Server-, Pfad- und Ressourcennamen müssen unterschiedlich sein.
Bei Dateien, die mit dem Internet Publishing-Anbieter verschoben werden, aktualisiert diese Methode alle Hypertextlinks in Dateien, die verschoben werden, sofern nicht anders durch Optionsangegeben. Diese Methode schlägt fehl, wenn Destination- ein vorhandenes Objekt (z. B. eine Datei oder ein Verzeichnis) identifiziert, es sei denn, adMoveOverWrite- angegeben ist.
Anmerkung
Verwenden Sie die option adMoveOverWrite sorgfältig. 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 nach Abschluss dieses Vorgangs nicht aktualisiert. Aktualisieren Sie die Eigenschaften des Record Objekts, indem Sie das Recordschließen und es dann erneut mit der URL des Speicherorts öffnen, an dem die Datei oder das Verzeichnis verschoben wurde.
Wenn diese Datensatz- aus einem Recordsetabgerufen wurde, wird der neue Speicherort der verschobenen Datei oder des verschobenen Verzeichnisses nicht sofort im Recordset-angezeigt. Aktualisieren Sie das Recordset-, indem Sie es schließen und erneut öffnen.
Anmerkung
URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet Publishingauf. Weitere Informationen finden Sie unter absoluten und relativen URLs.
Gilt für
Siehe auch
Move-Methode (ADO)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methoden (ADO)
Methoden MoveFirst, MoveLast, MoveNext und MovePrevious (RDS)