ZipFileExtensions.ExtractToFileAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Асинхронно создает файл в файловой системе с содержимым записи и указанным именем. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Асинхронно создает файл в файловой системе с содержимым записи и указанным именем. |
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)
- Исходный код:
- ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs
- Исходный код:
- ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs
Асинхронно создает файл в файловой системе с содержимым записи и указанным именем.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- source
- ZipArchiveEntry
Zip-архивная запись для извлечения файла из.
- destinationFileName
- String
Имя файла, который будет содержать содержимое записи.
- cancellationToken
- CancellationToken
Маркер отмены для отслеживания запросов на отмену.
Возвращаемое значение
Исключения
Вызывающий объект не имеет требуемого разрешения.
destinationFileName — строка нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов, определенных InvalidPathChars.
–или–
destinationFileName указывает каталог.
destinationFileName равно null.
Указанный путь, имя файла или оба превышают определенную системой максимальную длину. Например, на платформах под управлением Windows пути должны быть менее 248 символов, а имена файлов должны быть меньше 260 символов.
Недопустимый путь destinationFileName (например, он находится на несопоставленном диске).
Произошла ошибка ввода-вывода.
–или–
Запись в настоящее время открыта для записи.
–или–
Запись была удалена из архива.
destinationFileName имеет недопустимый формат.
–или–
ZipArchive, к которому принадлежит эта запись, была открыта в режиме только для записи.
Запись отсутствует в архиве или повреждена и не может быть прочитана.
–или–
Запись сжимается с помощью метода сжатия, который не поддерживается.
ZipArchive, к которому принадлежит эта запись, была удалена.
Комментарии
Указанный путь может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу.
Время последней записи файла устанавливается на время последней записи записи. Этот метод не разрешает перезапись существующего файла с тем же именем. Попытка извлечь явные каталоги (записи с именами, заканчивающимися символами разделителя каталогов) не приведет к созданию каталога.
Применяется к
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)
- Исходный код:
- ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs
- Исходный код:
- ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs
Асинхронно создает файл в файловой системе с содержимым записи и указанным именем.
public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- source
- ZipArchiveEntry
Zip-архивная запись для извлечения файла из.
- destinationFileName
- String
Имя файла, который будет содержать содержимое записи.
- overwrite
- Boolean
true для перезаписи файлов; false Иначе.
- cancellationToken
- CancellationToken
Маркер отмены для отслеживания запросов на отмену.
Возвращаемое значение
Исключения
Вызывающий объект не имеет требуемого разрешения.
destinationFileName — строка нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов, определенных InvalidPathChars.
–или–
destinationFileName указывает каталог.
destinationFileName равно null.
Указанный путь, имя файла или оба превышают определенную системой максимальную длину. Например, на платформах под управлением Windows пути должны быть менее 248 символов, а имена файлов должны быть меньше 260 символов.
Недопустимый путь destinationFileName (например, он находится на несопоставленном диске).
Произошла ошибка ввода-вывода.
–или–
Запись в настоящее время открыта для записи.
–или–
Запись была удалена из архива.
destinationFileName имеет недопустимый формат.
–или–
ZipArchive, к которому принадлежит эта запись, была открыта в режиме только для записи.
Запись отсутствует в архиве или повреждена и не может быть прочитана.
–или–
Запись сжимается с помощью метода сжатия, который не поддерживается.
ZipArchive, к которому принадлежит эта запись, была удалена.
Асинхронная операция отменена.
Комментарии
Указанный путь может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу.
Время последней записи файла устанавливается на время последней записи записи.
Этот метод позволяет перезаписать существующий файл с тем же именем.
