TarFile.CreateFromDirectoryAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
| CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken) |
Asynchronicznie tworzy strumień tar zawierający wszystkie wpisy systemu plików z określonego katalogu. |
| CreateFromDirectoryAsync(String, String, Boolean, CancellationToken) |
Asynchronicznie tworzy archiwum tar z zawartości określonego katalogu i generuje je do określonej ścieżki. Opcjonalnie może zawierać katalog podstawowy jako prefiks nazw wpisów. |
CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)
- Źródło:
- TarFile.cs
- Źródło:
- TarFile.cs
- Źródło:
- TarFile.cs
Asynchronicznie tworzy strumień tar zawierający wszystkie wpisy systemu plików z określonego katalogu.
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 TaskParametry
- sourceDirectoryName
- String
Ścieżka katalogu do archiwizacji.
- destination
- Stream
Docelowy strumień archiwum.
- includeBaseDirectory
- Boolean
true w celu uwzględnienia nazwy katalogu podstawowego jako pierwszego segmentu ścieżki we wszystkich nazwach wpisów archiwum.
false aby wykluczyć nazwę katalogu podstawowego ze ścieżek nazw wpisów.
- cancellationToken
- CancellationToken
Token do monitorowania żądań anulowania. Wartość domyślna to None.
Zwraca
Zadanie reprezentujące operację tworzenia asynchronicznego.
Wyjątki
sourceDirectoryName lub destination to null.
Nie sourceDirectoryName można odnaleźć ścieżki katalogu.
Wystąpił wyjątek we/wy.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez CreateFromDirectory(String, Stream, Boolean)usługę .
Dotyczy
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)
- Źródło:
- TarFile.cs
- Źródło:
- TarFile.cs
- Źródło:
- TarFile.cs
Asynchronicznie tworzy archiwum tar z zawartości określonego katalogu i generuje je do określonej ścieżki. Opcjonalnie może zawierać katalog podstawowy jako prefiks nazw wpisów.
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 TaskParametry
- sourceDirectoryName
- String
Ścieżka katalogu do archiwizacji.
- destinationFileName
- String
Ścieżka pliku archiwum docelowego.
- includeBaseDirectory
- Boolean
true w celu uwzględnienia nazwy katalogu podstawowego jako pierwszego segmentu ścieżki we wszystkich nazwach wpisów archiwum.
false aby wykluczyć nazwę katalogu podstawowego ze ścieżek nazw wpisów.
- cancellationToken
- CancellationToken
Token do monitorowania żądań anulowania. Wartość domyślna to None.
Zwraca
Zadanie reprezentujące operację tworzenia asynchronicznego.
Wyjątki
sourceDirectoryName lub destinationFileName to null.
sourceDirectoryName lub destinationFileName jest pusty.
Nie sourceDirectoryName można odnaleźć ścieżki katalogu.
Wystąpił wyjątek we/wy.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez CreateFromDirectory(String, String, Boolean)usługę .
