TarFile.CreateFromDirectoryAsync 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
| CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken) |
Erstellt asynchron einen Tar-Stream, der alle Dateisystemeinträge aus dem angegebenen Verzeichnis enthält. |
| CreateFromDirectoryAsync(String, String, Boolean, CancellationToken) |
Erstellt asynchron ein Tar-Archiv aus dem Inhalt des angegebenen Verzeichnisses und gibt es im angegebenen Pfad aus. Kann optional das Basisverzeichnis als Präfix für die Eintragsnamen einschließen. |
CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
Erstellt asynchron einen Tar-Stream, der alle Dateisystemeinträge aus dem angegebenen Verzeichnis enthält.
public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);static member CreateFromDirectoryAsync : string * System.IO.Stream * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceDirectoryName
- String
Der Pfad des zu archivierenden Verzeichnisses.
- destination
- Stream
Der Zielstream des Archivs.
- includeBaseDirectory
- Boolean
true , um den Namen des Basisverzeichnisses als erstes Pfadsegment in alle Namen der Archiveinträge einzuschließen. false , um den Namen des Basisverzeichnisses aus den Eintragsnamenpfaden auszuschließen.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Erstellungsvorgang darstellt.
Ausnahmen
sourceDirectoryName oder destination ist null.
sourceDirectoryName ist leer.
- oder -
destination unterstützt das Schreiben nicht.
Der sourceDirectoryName Verzeichnispfad wurde nicht gefunden.
Es ist eine E/A-Ausnahme aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die sie 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten CreateFromDirectory(String, Stream, Boolean)Ausnahmen.
Gilt für:
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
- Quelle:
- TarFile.cs
Erstellt asynchron ein Tar-Archiv aus dem Inhalt des angegebenen Verzeichnisses und gibt es im angegebenen Pfad aus. Kann optional das Basisverzeichnis als Präfix für die Eintragsnamen einschließen.
public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);static member CreateFromDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParameter
- sourceDirectoryName
- String
Der Pfad des zu archivierenden Verzeichnisses.
- destinationFileName
- String
Der Pfad der Zielarchivdatei.
- includeBaseDirectory
- Boolean
true , um den Namen des Basisverzeichnisses als erstes Pfadsegment in alle Namen der Archiveinträge einzuschließen. false , um den Namen des Basisverzeichnisses aus den Eintragsnamenpfaden auszuschließen.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Erstellungsvorgang darstellt.
Ausnahmen
sourceDirectoryName oder destinationFileName ist null.
sourceDirectoryName oder destinationFileName ist leer.
Der sourceDirectoryName Verzeichnispfad wurde nicht gefunden.
Es ist eine E/A-Ausnahme aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese Methode speichert in der Aufgabe, die sie 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten CreateFromDirectory(String, String, Boolean)Ausnahmen.
