Freigeben über


TarFile.CreateFromDirectoryAsync Methode

Definition

Überlädt

Name Beschreibung
CreateFromDirectoryAsync(String, String, Boolean, TarWriterOptions, CancellationToken)
CreateFromDirectoryAsync(String, String, Boolean, TarEntryFormat, CancellationToken)
CreateFromDirectoryAsync(String, Stream, Boolean, TarWriterOptions, CancellationToken)
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Erstellt asynchron ein Tar-Archiv aus dem Inhalt des angegebenen Verzeichnisses und gibt sie in den angegebenen Pfad aus. Kann optional das Basisverzeichnis als Präfix für die Eintragsnamen einschließen.

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)

Erstellt asynchron einen Tar-Datenstrom, der alle Dateisystemeinträge aus dem angegebenen Verzeichnis enthält.

CreateFromDirectoryAsync(String, Stream, Boolean, TarEntryFormat, CancellationToken)

CreateFromDirectoryAsync(String, String, Boolean, TarWriterOptions, CancellationToken)

Quelle:
TarFile.cs
public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Formats.Tar.TarWriterOptions options, System.Threading.CancellationToken cancellationToken = default);
static member CreateFromDirectoryAsync : string * string * bool * System.Formats.Tar.TarWriterOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, options As TarWriterOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sourceDirectoryName
String
destinationFileName
String
includeBaseDirectory
Boolean
cancellationToken
CancellationToken

Gibt zurück

Gilt für:

CreateFromDirectoryAsync(String, String, Boolean, TarEntryFormat, CancellationToken)

Quelle:
TarFile.cs
public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Formats.Tar.TarEntryFormat format, System.Threading.CancellationToken cancellationToken = default);
static member CreateFromDirectoryAsync : string * string * bool * System.Formats.Tar.TarEntryFormat * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, format As TarEntryFormat, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sourceDirectoryName
String
destinationFileName
String
includeBaseDirectory
Boolean
cancellationToken
CancellationToken

Gibt zurück

Gilt für:

CreateFromDirectoryAsync(String, Stream, Boolean, TarWriterOptions, CancellationToken)

Quelle:
TarFile.cs
public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Formats.Tar.TarWriterOptions options, System.Threading.CancellationToken cancellationToken = default);
static member CreateFromDirectoryAsync : string * System.IO.Stream * bool * System.Formats.Tar.TarWriterOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, options As TarWriterOptions, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sourceDirectoryName
String
destination
Stream
includeBaseDirectory
Boolean
cancellationToken
CancellationToken

Gibt zurück

Gilt für:

CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Quelle:
TarFile.cs
Quelle:
TarFile.cs
Quelle:
TarFile.cs
Quelle:
TarFile.cs
Quelle:
TarFile.cs

Erstellt asynchron ein Tar-Archiv aus dem Inhalt des angegebenen Verzeichnisses und gibt sie in den 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.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sourceDirectoryName
String

Der Pfad des zu archivierenden Verzeichnisses.

destinationFileName
String

Der Pfad der Zielarchivdatei.

includeBaseDirectory
Boolean

true um den Basisverzeichnisnamen als erstes Pfadsegment in alle Namen der Archiveinträge einzuschließen. false um den Basisverzeichnisnamen aus den Eintragsnamenpfaden auszuschließen.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. 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 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 CreateFromDirectory(String, String, Boolean).

Gilt für:

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)

Quelle:
TarFile.cs
Quelle:
TarFile.cs
Quelle:
TarFile.cs
Quelle:
TarFile.cs
Quelle:
TarFile.cs

Erstellt asynchron einen Tar-Datenstrom, 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.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sourceDirectoryName
String

Der Pfad des zu archivierenden Verzeichnisses.

destination
Stream

Der Zieldatenstrom des Archivs.

includeBaseDirectory
Boolean

true um den Basisverzeichnisnamen als erstes Pfadsegment in alle Namen der Archiveinträge einzuschließen. false um den Basisverzeichnisnamen aus den Eintragsnamenpfaden auszuschließen.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. 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 das Schreiben wird nicht unterstützt.

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 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 CreateFromDirectory(String, Stream, Boolean).

Gilt für:

CreateFromDirectoryAsync(String, Stream, Boolean, TarEntryFormat, CancellationToken)

Quelle:
TarFile.cs
public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Formats.Tar.TarEntryFormat format, System.Threading.CancellationToken cancellationToken = default);
static member CreateFromDirectoryAsync : string * System.IO.Stream * bool * System.Formats.Tar.TarEntryFormat * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, format As TarEntryFormat, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

sourceDirectoryName
String
destination
Stream
includeBaseDirectory
Boolean
cancellationToken
CancellationToken

Gibt zurück

Gilt für: