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
Токен отмены.
Возвращаемое значение
Задача, представляющая асинхронную операцию копирования.
Исключения
sourceUri имеет значение null или destinationUri имеет значение null.
sourceUri — не существует.
Родительский объект не destinationUri существует.
sourceUri ссылается на файл, destinationUri уже существует и overwrite имеет значение false.
ErrorCode будет иметь значение FileAlreadyExists .
У вызывающего объекта отсутствует необходимое разрешение.
Комментарии
Если sourceUri ссылается на каталог и overwrite имеет значение true, destinationUri то удаляется до выполнения копирования. Если sourceUri ссылается на каталог и overwrite имеет значение false, то исходный каталог объединяется с существующим содержимым каталога назначения.