IFileSystemProvider.CopyAsync(Uri, Uri, Boolean, IProgress<OperationProgressData>, CancellationToken) Methode

Definition

Kopiert eine Datei oder ein Verzeichnis.

public:
 System::Threading::Tasks::Task ^ CopyAsync(Uri ^ sourceUri, Uri ^ destinationUri, bool overwrite, IProgress<Microsoft::VisualStudio::RpcContracts::FileSystem::OperationProgressData> ^ progress, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task CopyAsync (Uri sourceUri, Uri destinationUri, bool overwrite, IProgress<Microsoft.VisualStudio.RpcContracts.FileSystem.OperationProgressData>? progress, System.Threading.CancellationToken cancellationToken);
abstract member CopyAsync : Uri * Uri * bool * IProgress<Microsoft.VisualStudio.RpcContracts.FileSystem.OperationProgressData> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function CopyAsync (sourceUri As Uri, destinationUri As Uri, overwrite As Boolean, progress As IProgress(Of OperationProgressData), cancellationToken As CancellationToken) As Task

Parameter

sourceUri
Uri

Die vorhandene Datei oder das vorhandene Verzeichnis.

destinationUri
Uri

Der neue Speicherort.

overwrite
Boolean

True, wenn vorhandene Dateien überschrieben werden sollen. andernfalls false.

progress
IProgress<OperationProgressData>

Die Schnittstelle, über die der Status gemeldet wird.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Kopiervorgang darstellt.

Ausnahmen

sourceUri ist NULL oder destinationUri ist NULL.

sourceUri existiert nicht.

Das übergeordnete Element von destinationUri ist nicht vorhanden.

sourceUri verweist auf eine Datei, destinationUri ist bereits vorhanden und overwrite ist false. ErrorCode wird auf festgelegt FileAlreadyExists .

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Wenn sourceUri auf ein Verzeichnis verweist und overwrite den Wert true hat, destinationUri wird entfernt, bevor der Kopiervorgang ausgeführt wird. Wenn sourceUri auf ein Verzeichnis verweist und auf overwrite false festgelegt ist, wird das Quellverzeichnis in den vorhandenen Inhalt des Zielverzeichnisses zusammengeführt.

Gilt für