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