IFileSystemProvider.CopyAsync(Uri, Uri, Boolean, IProgress<OperationProgressData>, CancellationToken) Метод

Определение

Копирует файл или каталог.

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

Параметры

sourceUri
Uri

Существующий файл или каталог.

destinationUri
Uri

Новое расположение.

overwrite
Boolean

Значение true, чтобы перезаписать существующие файлы; в противном случае — false.

progress
IProgress<OperationProgressData>

Интерфейс, с помощью которого сообщается ход выполнения.

cancellationToken
CancellationToken

Токен отмены.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию копирования.

Исключения

sourceUri имеет значение null или destinationUri имеет значение null.

sourceUri — не существует.

Родительский объект не destinationUri существует.

sourceUri ссылается на файл, destinationUri уже существует и overwrite имеет значение false. ErrorCode будет иметь значение FileAlreadyExists .

У вызывающего объекта отсутствует необходимое разрешение.

Комментарии

Если sourceUri ссылается на каталог и overwrite имеет значение true, destinationUri то удаляется до выполнения копирования. Если sourceUri ссылается на каталог и overwrite имеет значение false, то исходный каталог объединяется с существующим содержимым каталога назначения.

Применяется к