TarWriter.WriteEntryAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| Имя | Описание |
|---|---|
| WriteEntryAsync(TarEntry, CancellationToken) |
Асинхронно записывает указанную запись в архивный поток. |
| WriteEntryAsync(String, String, CancellationToken) |
Асинхронно записывает указанный файл в архивный поток в виде записи tar. |
WriteEntryAsync(TarEntry, CancellationToken)
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
Асинхронно записывает указанную запись в архивный поток.
public System.Threading.Tasks.Task WriteEntryAsync(System.Formats.Tar.TarEntry entry, System.Threading.CancellationToken cancellationToken = default);member this.WriteEntryAsync : System.Formats.Tar.TarEntry * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- entry
- TarEntry
Запись tar для записи.
- cancellationToken
- CancellationToken
Маркер для отслеживания запросов на отмену. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
Исключения
Тип записи или HardLink пустой LinkNamenull.SymbolicLink
Архивный поток удаляется.
entry равно null.
Возникла проблема ввода-вывода.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Перед записью записи в архив, если вы записали данные в запись DataStream, обязательно перемотите ее на нужную позицию начала.
Это типы записей, поддерживаемые для записи в каждом формате:
V7:
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteEntry(TarEntry).
Применяется к
WriteEntryAsync(String, String, CancellationToken)
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
- Исходный код:
- TarWriter.cs
Асинхронно записывает указанный файл в архивный поток в виде записи tar.
public System.Threading.Tasks.Task WriteEntryAsync(string fileName, string? entryName, System.Threading.CancellationToken cancellationToken = default);member this.WriteEntryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskПараметры
- fileName
- String
Путь к файлу для записи в архив.
- entryName
- String
Имя файла, как оно должно быть представлено в архиве. Он должен включать необязательный относительный путь и имя файла.
- cancellationToken
- CancellationToken
Маркер для отслеживания запросов на отмену. Значение по умолчанию — None.
Возвращаемое значение
Задача, представляющая асинхронную операцию записи.
Исключения
Архивный поток удаляется.
fileName
entryName или null пуст.
Возникла проблема ввода-вывода.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteEntry(String, String).
