TarWriter.WriteEntryAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Sobrecargas
| Name | Descrição |
|---|---|
| WriteEntryAsync(TarEntry, CancellationToken) |
Escreve assíncronamente a entrada especificada no fluxo de arquivo. |
| WriteEntryAsync(String, String, CancellationToken) |
Escreve assíncronamente o ficheiro especificado no fluxo de arquivo como uma entrada tar. |
WriteEntryAsync(TarEntry, CancellationToken)
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
Escreve assíncronamente a entrada especificada no fluxo de arquivo.
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.Task
Public Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As Task
Parâmetros
- entry
- TarEntry
A entrada de alcatrão para escrever.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
O tipo de entrada é HardLink ou SymbolicLink e o LinkName é null ou vazio.
O fluxo de arquivo é eliminado.
entry é null.
Ocorreu um problema de I/O.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Antes de escrever uma entrada no arquivo, se escreveu dados nas entradas DataStream, certifique-se de recuar até à posição inicial desejada.
Estes são os tipos de entrada suportados para escrita em cada formato:
V7:
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteEntry(TarEntry).
Aplica-se a
WriteEntryAsync(String, String, CancellationToken)
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
- Origem:
- TarWriter.cs
Escreve assíncronamente o ficheiro especificado no fluxo de arquivo como uma entrada 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.Task
Public Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task
Parâmetros
- fileName
- String
O caminho até ao ficheiro para escrever no arquivo.
- entryName
- String
O nome do ficheiro como deve ser representado no arquivo. Deve incluir o caminho relativo opcional e o nome do ficheiro.
- cancellationToken
- CancellationToken
O token para monitorizar pedidos de cancelamento. O valor predefinido é None.
Devoluções
Uma tarefa que representa a operação de escrita assíncrona.
Exceções
O fluxo de arquivo é eliminado.
fileName ou entryName é null ou vazia.
Ocorreu um problema de I/O.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por WriteEntry(String, String).