CopyRecord-Methode (ADO)
Gilt für: Access 2013, Office 2013
Kopiert eine durch einen Record dargestellte Entität an einen anderen Speicherort.
Syntax
Datensatz. CopyRecord (Quelle, Ziel, Benutzername, Kennwort, Optionen, Async)
Parameter
| Parameter | Beschreibung |
|---|---|
| Source | 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 ausgelassen wird oder eine leere Zeichenfolge angibt, wird die Datei oder das Verzeichnis, die bzw. das durch den aktuellen Datensatz dargestellt wird, kopiert. |
| Ziel | Optional. Ein String-Wert mit einer URL, die den Speicherort angibt, an den die Source kopiert werden soll. |
| UserName | Optional. Ein String-Wert mit der Benutzer-ID, die bei Bedarf Zugriff auf die Destination gewährt. |
| Password | Optional. Ein String-Wert, der das Kennwort enthält, das bei Bedarf den UserName bestätigt. |
| Optionen | Optional. Ein CopyRecordOptionsEnum-Wert, der den Standardwert adCopyUnspecified besitzt. Gibt das Verhalten dieser Methode an. |
| Async | Optional. Ein Boolean -Wert, der im Fall von True angibt, dass dieser Vorgang asynchron sein soll. |
Rückgabewert
Ein String-Wert, der in der Regel den Wert für Destination zurückgibt. Der genaue Wert, der zurückgegeben wird, ist jedoch vom Anbieter abhängig.
Hinweise
Die Werte für Source und Destination dürfen nicht identisch sein, andernfalls tritt ein Laufzeitfehler auf. Mindestens einer der Server-, Pfad- oder Ressourcennamen muss unterschiedlich sein.
Wenn adCopyNonRecursive nicht angegeben ist, werden alle untergeordneten Ebenen (z. B. Unterverzeichnisse) von Source rekursiv kopiert. Bei einem rekursiven Vorgang darf es sich bei der Destination nicht um ein Unterverzeichnis von Source handeln, andernfalls kann der Vorgang nicht abgeschlossen werden.
Diese Methode schlägt fehl, wenn die Destination eine vorhandene Entität (z. B. eine Datei oder ein Verzeichnis) angibt und adCopyOverWrite nicht angegeben ist.
Wichtig
Verwenden Sie die Option adCopyOverWrite nur nach sorgfältiger Überlegung. Wenn Sie diese Option beispielsweise beim Kopieren einer Datei in ein Verzeichnis angeben, wird das Verzeichnis gelöscht und durch die Datei ersetzt.
Hinweis
Bei URLs, die das HTTP-Schema verwenden, wird automatisch der Microsoft OLE DB-Anbieter für Internet Publishing aufgerufen. Weitere Informationen finden Sie unter Absolute und relative URLs.