CopyRecord-Methode (ADO)
Kopiert eine Entität, die durch einen Datensatz dargestellt wird, an einen anderen Speicherort.
Syntax
Record.CopyRecord (Source, Destination, UserName, Password, Options, Async)
Parameter
Source-
Wahlfrei. Ein String Wert, der eine URL enthält, die die zu kopierende Entität angibt (z. B. eine Datei oder ein Verzeichnis). Wenn Source ausgelassen wird oder eine leere Zeichenfolge angibt, wird die datei oder das Verzeichnis, die durch die aktuelle Record dargestellt wird, kopiert.
Ziel-
Wahlfrei. Ein String--Wert, der eine URL enthält, die den Speicherort angibt, an dem Source kopiert wird.
UserName-
Wahlfrei. Ein String Wert, der die Benutzer-ID enthält, die bei Bedarf den Zugriff auf Ziel-autorisiert.
Kennwort
Wahlfrei. Ein String- Wert, der das Kennwort enthält, das bei Bedarf UserNameüberprüft.
Optionen
Wahlfrei. Ein CopyRecordOptionsEnum Wert mit einem Standardwert adCopyUnspecified. 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, der in der Regel den Wert Destinationzurückgibt. 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 einer der Server-, Pfad- oder Ressourcennamen muss unterschiedlich sein.
Alle untergeordneten Elemente (z. B. Unterverzeichnisse) Source werden rekursiv kopiert, es sei denn, adCopyNonRecursive angegeben ist. Bei einem rekursiven Vorgang darf Ziel- kein Unterverzeichnis Source-sein; andernfalls wird der Vorgang nicht abgeschlossen.
Diese Methode schlägt fehl, wenn Destination eine vorhandene Entität (z. B. eine Datei oder ein Verzeichnis) identifiziert, es sei denn, adCopyOverWrite- angegeben ist.
Wichtig
Verwenden Sie die option adCopyOverWrite sorgfältig. Wenn Sie diese Option beispielsweise beim Kopieren einer Datei in ein Verzeichnis angeben, sie Verzeichnis zu löschen und durch die Datei zu ersetzen.
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.