TarWriter.WriteEntryAsync Metodo

Definizione

Spazio dei nomi:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Overload

WriteEntryAsync(TarEntry, CancellationToken)	Scrive in modo asincrono la voce specificata nel flusso di archiviazione.
WriteEntryAsync(String, String, CancellationToken)	Scrive in modo asincrono il file specificato nel flusso di archiviazione come voce tar.

WriteEntryAsync(TarEntry, CancellationToken)

Origine:

TarWriter.cs

Scrive in modo asincrono la voce specificata nel flusso di archiviazione.

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

Parametri

entry

TarEntry

Voce tar da scrivere.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ArgumentException

Il tipo di voce è HardLink o SymbolicLink e l'oggetto LinkName è null o vuoto.

ObjectDisposedException

Il flusso di archiviazione viene eliminato.

ArgumentNullException

entry è null.

IOException

Si è verificato un problema di I/O.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Prima di scrivere una voce nell'archivio, se i dati sono stati scritti nella voce DataStream, assicurarsi di riavvolgerlo nella posizione iniziale desiderata.

Questi sono i tipi di voce supportati per la scrittura in ogni formato:

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Paxe Gnu:

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

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteEntry(TarEntry).

WriteEntryAsync(String, String, CancellationToken)

Origine:

TarWriter.cs

Scrive in modo asincrono il file specificato nel flusso di archiviazione come voce 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

Parametri

fileName

String

Percorso del file da scrivere nell'archivio.

entryName

String

Nome del file come deve essere rappresentato nell'archivio. Deve includere il percorso relativo facoltativo e il nome file.

cancellationToken

CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

Task

Attività che rappresenta l'operazione di scrittura asincrona.

Eccezioni

ObjectDisposedException

Il flusso di archiviazione viene eliminato.

ArgumentException

fileName o entryName è null o vuoto.

IOException

Si è verificato un problema di I/O.

OperationCanceledException

Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.

Commenti

Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da WriteEntry(String, String).