TarWriter.WriteEntryAsync Método

Definición

Espacio de nombres:

System.Formats.Tar

Ensamblado:

System.Formats.Tar.dll

Sobrecargas

WriteEntryAsync(TarEntry, CancellationToken)	Escribe de forma asincrónica la entrada especificada en la secuencia de archivo.
WriteEntryAsync(String, String, CancellationToken)	Escribe de forma asincrónica el archivo especificado en la secuencia de archivo como una entrada tar.

WriteEntryAsync(TarEntry, CancellationToken)

Source:

TarWriter.cs

Escribe de forma asincrónica la entrada especificada en la secuencia de archivo.

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

Entrada tar que se va a escribir.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ArgumentException

El tipo de entrada es HardLink o SymbolicLink y es LinkName o está null vacío.

ObjectDisposedException

La secuencia de archivo se elimina.

ArgumentNullException

entry es null.

IOException

Se ha producido un problema de E/S.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Antes de escribir una entrada en el archivo, si escribió datos en la entrada de DataStream, asegúrese de rebobinarla en la posición inicial deseada.

Estos son los tipos de entrada admitidos para escribir en cada formato:

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Paxy Gnu:

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

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteEntry(TarEntry).

WriteEntryAsync(String, String, CancellationToken)

Source:

TarWriter.cs

Escribe de forma asincrónica el archivo especificado en la secuencia de archivo como una 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

Ruta de acceso al archivo que se va a escribir en el archivo.

entryName

String

El nombre del archivo como debe representarse en el archivo. Debe incluir la ruta de acceso relativa opcional y el nombre de archivo.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task

Tarea que representa la operación de escritura asincrónica.

Excepciones

ObjectDisposedException

La secuencia de archivo se elimina.

ArgumentException

El valor de fileName o entryName es null o está vacío.

IOException

Se ha producido un problema de E/S.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por WriteEntry(String, String).