TarWriter.WriteEntryAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ü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:
V7:
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).