TarWriter.WriteEntryAsync Metoda

Definice

Obor názvů:

System.Formats.Tar

Sestavení:

System.Formats.Tar.dll

Přetížení

WriteEntryAsync(TarEntry, CancellationToken)	Asynchronně zapíše zadanou položku do archivního datového proudu.
WriteEntryAsync(String, String, CancellationToken)	Asynchronně zapíše zadaný soubor do archivního datového proudu jako záznam tar.

WriteEntryAsync(TarEntry, CancellationToken)

Zdroj:

TarWriter.cs

Asynchronně zapíše zadanou položku do archivního datového proudu.

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

Parametry

entry

TarEntry

Položka tar, která se má zapsat.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ArgumentException

Typ položky je HardLink nebo SymbolicLink a je LinkNamenull nebo prázdný.

ObjectDisposedException

Archivní datový proud je odstraněn.

ArgumentNullException

entry je null.

IOException

Došlo k problému se vstupně-výstupními operacemi.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Pokud jste před zápisem položky do archivu zapisovali data do DataStreampoložky , nezapomeňte ji převinout na požadovanou počáteční pozici.

Pro zápis v jednotlivých formátech se podporují tyto typy položek:

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Paxa Gnu:

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

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteEntry(TarEntry).

WriteEntryAsync(String, String, CancellationToken)

Zdroj:

TarWriter.cs

Asynchronně zapíše zadaný soubor do archivního datového proudu jako záznam 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

Parametry

fileName

String

Cesta k souboru pro zápis do archivu.

entryName

String

Název souboru tak, jak by měl být reprezentován v archivu. Měla by obsahovat volitelnou relativní cestu a název souboru.

cancellationToken

CancellationToken

Token, který se má monitorovat pro žádosti o zrušení. Výchozí hodnota je None.

Návraty

Task

Úloha, která představuje asynchronní operaci zápisu.

Výjimky

ObjectDisposedException

Archivní datový proud je odstraněn.

ArgumentException

fileName nebo entryName je null nebo je prázdná.

IOException

Došlo k problému se vstupně-výstupními operacemi.

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka je uložena ve vrácené úloze.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nesouvisejí s používáním, které může vyvolat synchronní protějšek metody. Pokud je ve vrácené úloze uložena výjimka, bude tato výjimka vyvolána při čekání na úkol. Výjimky použití, například ArgumentException, jsou stále vyvolány synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem WriteEntry(String, String).