MoveRecord-Methode (ADO)
Verschiebt die durch ein Record-Objekt dargestellte Entität an einen anderen Speicherort.
Syntax
Record.MoveRecord (Source, Destination, UserName, Password, Options, Async)
Parameter
Quelle
Optional. Ein String-Wert, der eine URL enthält, die das zu verschiebenden Record-Objekt identifiziert. Wenn Source (Quelle) nicht angegeben ist oder eine leere Zeichenfolge angibt, wird das durch dieses Record-Objekt dargestellte Objekt verschoben. Wenn das Record-Objekt beispielsweise eine Datei darstellt, werden die Inhalte der Datei an den von Destination (Ziel) angegebenen Speicherort verschoben.
Ziel
Optional. Ein String-Wert, der eine URL enthält, die den Speicherort angibt, an den Source verschoben wird.
UserName
Optional. Ein String-Wert, der die Benutzer-ID enthält, die erforderlichenfalls den Zugriff auf Destination autorisiert.
Kennwort
Optional. Ein String-Wert, der das Kennwort enthält, das erforderlichenfalls UserName überprüft.
Optionen
Optional. Ein MoveRecordOptionsEnum-Wert, dessen Standardwert adMoveUnspecified ist. Gibt das Verhalten dieser Methode an.
Asynchron
Optional. Ein boolescher Wert. Ist er True, gibt er an, dass dieser Vorgang asynchron sein soll.
Rückgabewert
Ein String-Wert. Normalerweise wird der Wert von Destination zurückgegeben. Der genaue Wert, der zurückgegeben wird, ist jedoch vom Anbieter abhängig.
Bemerkungen
Die Werte von Source und Destination dürfen nicht identisch sein, andernfalls tritt ein Laufzeitfehler auf. Mindestens einer der Namen von Server, Pfad oder Ressource muss anders lauten.
Sofern von Options nicht anders angegeben, werden mit dieser Methode bei Dateien, die mithilfe des Anbieters für Internet-Publishing verschoben werden, alle darin enthaltenen Hypertextlinks aktualisiert. 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 adMoveOverWrite-Option mit Bedacht. 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 Record-Objekt schließen dann erneut mit der URL des Speicherorts öffnen, an den die Datei oder das Verzeichnis verschoben wurde.
Wenn dieses Record-Objekt aus einem Recordset abgerufen wurde, wird der neue Speicherort der verschobenen Datei bzw. des verschobenen Verzeichnisses nicht sofort im Recordset angezeigt. Aktualisieren Sie das Recordset, indem Sie es schließen und erneut öffnen.
Hinweis
URLs, die das HTTP-Schema verwenden, rufen automatisch den Microsoft OLE DB-Anbieter für Internet-Publishing auf. Weitere Informationen finden Sie unter Absolute und relative URLs.
Gilt für
Weitere Informationen
Move-Methode (ADO)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methode (ADO)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methode (RDS)