CopyRecord-Methode (ADO)

Kopiert eine Entität, die durch ein Record-Objekt dargestellt wird, an einen anderen Speicherort.

Syntax

  
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)  

Parameter

Quelle
Optional. Ein String-Wert, der eine URL enthält, die die zu kopierende Entität angibt (z. B. eine Datei oder ein Verzeichnis). Wenn Source nicht oder darin eine leere Zeichenfolge angegeben ist, wird die/das durch den aktuellen Recordset Datensatz dargestellte Datei/Verzeichnis kopiert.

Ziel
Optional. Ein String-Wert, der eine URL enthält, die den Speicherort angibt, an den Source (Quelle) kopiert 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 den UserName überprüft.

Optionen
Optional. Ein CopyRecordOptionsEnum-Wert mit einem Standardwert von adCopyUnspecified. Gibt das Verhalten dieser Methode an.

Asynchron
Optional. Ein boolescher Wert, der, wenn True, angibt, dass dieser Vorgang asynchron sein soll.

Rückgabewert

Ein String-Wert, der in der Regel den Wert von Destination (Ziel) zurückgibt. 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 sich unterscheiden.

Alle untergeordneten Elemente (z. B. Unterverzeichnisse) von Source werden rekursiv kopiert, es sei denn, adCopyNonRecursive ist angegeben. Bei einem rekursiven Vorgang darf Destination kein Unterverzeichnis von Source sein, da der Vorgang andernfalls nicht abgeschlossen wird.

Diese Methode schlägt fehl, wenn Destination eine vorhandene Entität (z. B. eine Datei oder ein Verzeichnis) identifiziert, es sei denn, adCopyOverWrite ist angegeben.

Wichtig

Verwenden Sie die adCopyOverWrite-Option mit Bedacht. Wenn Sie diese Option beispielsweise angeben, wenn Sie eine Datei in ein Verzeichnis kopieren, wird das Verzeichnis gelöscht und durch die Datei ersetzt.

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)