TarWriter.WriteEntryAsync Método

Definição

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

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

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

Task

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

Exceções

ArgumentException

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

ObjectDisposedException

O fluxo de arquivos é descartado.

ArgumentNullException

entry é null.

IOException

Ocorreu um problema de E/S.

OperationCanceledException

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:

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Paxe Gnu:

  • BlockDevice
  • CharacterDevice
  • Directory
  • Fifo
  • HardLink
  • RegularFile
  • SymbolicLink

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

WriteEntryAsync(String, String, CancellationToken)

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

Task

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

Exceções

ObjectDisposedException

O fluxo de arquivos é descartado.

ArgumentException

fileName ou entryName é null ou vazio.

IOException

Ocorreu um problema de E/S.

OperationCanceledException

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