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