TarWriter.WriteEntryAsync Methode

Definition

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Überlädt

WriteEntryAsync(TarEntry, CancellationToken)	Schreibt den angegebenen Eintrag asynchron in den Archivdatenstrom.
WriteEntryAsync(String, String, CancellationToken)	Schreibt die angegebene Datei asynchron als tar-Eintrag in den Archivdatenstrom.

WriteEntryAsync(TarEntry, CancellationToken)

Quelle:

TarWriter.cs

Schreibt den angegebenen Eintrag asynchron in den Archivdatenstrom.

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

Parameter

entry

TarEntry

Der zu schreibende Tar-Eintrag.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ArgumentException

Der Eintragstyp ist HardLink oder SymbolicLink , und der LinkName ist null oder leer.

ObjectDisposedException

Der Archivdatenstrom wird verworfen.

ArgumentNullException

entry ist null

IOException

Ein E/A-Problem ist aufgetreten.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn Sie Vor dem Schreiben eines Eintrags in das Archiv Daten in den Eintrag geschrieben haben DataStream, stellen Sie sicher, dass Sie ihn an die gewünschte Startposition zurückspulen.

Dies sind die Eingabetypen, die für das Schreiben in jedem Format unterstützt werden:

• V7:

  • Directory
  • HardLink
  • SymbolicLink
  • V7RegularFile

• Ustar, Paxund Gnu:

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

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteEntry(TarEntry).

WriteEntryAsync(String, String, CancellationToken)

Quelle:

TarWriter.cs

Schreibt die angegebene Datei asynchron als tar-Eintrag in den Archivdatenstrom.

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

Parameter

fileName

String

Der Pfad zur Datei, die in das Archiv geschrieben werden soll.

entryName

String

Der Name der Datei, wie sie im Archiv dargestellt werden soll. Sie sollte den optionalen relativen Pfad und den Dateinamen enthalten.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Task

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

ObjectDisposedException

Der Archivdatenstrom wird verworfen.

ArgumentException

fileName oder entryName hat den Wert null oder ist leer.

IOException

Ein E/A-Problem ist aufgetreten.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden WriteEntry(String, String).