Idioma

TarWriter.WriteEntryAsync Método

Definição

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:

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).

Aplica-se a