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
| Name | Beschreibung |
|---|---|
| WriteEntryAsync(TarEntry, CancellationToken) |
Schreibt asynchron den angegebenen Eintrag 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
- Quelle:
- TarWriter.cs
- Quelle:
- TarWriter.cs
Schreibt asynchron den angegebenen Eintrag 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.TaskPublic Function WriteEntryAsync (entry As TarEntry, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- entry
- TarEntry
Der zu schreibende Tar-Eintrag.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
Der Eintragstyp ist HardLink oder ist LinkNamenull oder SymbolicLink leer.
Der Archivdatenstrom ist verworfen.
entry ist null.
Ein E/A-Problem ist aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Bevor Sie einen Eintrag in das Archiv schreiben, stellen Sie sicher, dass Sie ihn an die gewünschte Startposition zurückspulen, wenn Sie Daten in den Eintrag DataStreamgeschrieben haben.
Dies sind die Eingabetypen, die für das Schreiben in jedem Format unterstützt werden:
V7:
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteEntry(TarEntry).
Gilt für:
WriteEntryAsync(String, String, CancellationToken)
- Quelle:
- TarWriter.cs
- Quelle:
- TarWriter.cs
- 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.TaskPublic Function WriteEntryAsync (fileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- fileName
- String
Der Pfad zu der Datei, die in das Archiv geschrieben werden soll.
- entryName
- String
Der Name der Datei, wie sie im Archiv dargestellt werden soll. Er sollte den optionalen relativen Pfad und den Dateinamen enthalten.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.
Ausnahmen
Der Archivdatenstrom ist verworfen.
fileName oder entryName ist null oder 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 Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteEntry(String, String).
