Freigeben über


TarWriter.WriteEntryAsync Methode

Definition

Ü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
Quelle:
TarWriter.cs
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

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

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

Der Archivdatenstrom wird verworfen.

entry ist null

Ein E/A-Problem ist aufgetreten.

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:

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

Gilt für:

WriteEntryAsync(String, String, CancellationToken)

Quelle:
TarWriter.cs
Quelle:
TarWriter.cs
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

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

Der Archivdatenstrom wird verworfen.

fileName oder entryName hat den Wert null oder ist leer.

Ein E/A-Problem ist aufgetreten.

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

Gilt für: