Partilhar via


TarWriter.WriteEntryAsync Método

Definição

Sobrecargas

WriteEntryAsync(TarEntry, CancellationToken)

Grava de forma assíncrona a entrada especificada no fluxo de arquivos.

WriteEntryAsync(String, String, CancellationToken)

Grava de forma assíncrona o arquivo especificado no fluxo de arquivos como uma entrada tar.

WriteEntryAsync(TarEntry, CancellationToken)

Origem:
TarWriter.cs
Origem:
TarWriter.cs
Origem:
TarWriter.cs

Grava de forma assíncrona a entrada especificada no fluxo de arquivos.

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 tar a ser gravada.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

O tipo de entrada é HardLink ou SymbolicLink e o LinkName é null ou vazio.

O fluxo de arquivos é descartado.

entry é null.

Ocorreu um problema de E/S.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Antes de gravar uma entrada no arquivo morto, se você tiver escrito dados no da DataStreamentrada, rebobine-os para a posição inicial desejada.

Estes são os tipos de entrada com suporte para gravação em cada formato:

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteEntry(TarEntry).

Aplica-se a

WriteEntryAsync(String, String, CancellationToken)

Origem:
TarWriter.cs
Origem:
TarWriter.cs
Origem:
TarWriter.cs

Grava de forma assíncrona o arquivo especificado no fluxo de arquivos 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 para o arquivo a ser gravado no arquivo morto.

entryName
String

O nome do arquivo como ele deve ser representado no arquivo morto. Ele deve incluir o caminho relativo opcional e o nome do arquivo.

cancellationToken
CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Uma tarefa que representa a operação de gravação assíncrona.

Exceções

O fluxo de arquivos é descartado.

fileName ou entryName é null ou vazio.

Ocorreu um problema de E/S.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por WriteEntry(String, String).

Aplica-se a