Freigeben über

MoveRecord-Methode (ADO)

  • Artikel

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

Record-Objekt (ADO)

Weitere Informationen

Move-Methode (ADO)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methode (ADO)
MoveFirst-, MoveLast-, MoveNext- und MovePrevious-Methode (RDS)