TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) 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.
Asynchronicznie wyodrębnia bieżący wpis do systemu plików.
public System.Threading.Tasks.Task ExtractToFileAsync (string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);member this.ExtractToFileAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- destinationFileName
- String
Ścieżka do pliku docelowego.
- overwrite
- Boolean
true jeśli ta metoda powinna zastąpić dowolny istniejący obiekt systemu plików znajdujący się w destinationFileName ścieżce, false aby zapobiec zastępowaniu.
- cancellationToken
- CancellationToken
Token do monitorowania żądań anulowania. Wartość domyślna to None.
Zwraca
Zadanie reprezentujące operację wyodrębniania asynchronicznego.
Wyjątki
destinationFileName to null.
destinationFileName jest pusty.
Katalog nadrzędny obiektu destinationFileName nie istnieje.
-lub-
overwrite jest i false plik już istnieje w pliku destinationFileName.
-lub-
Katalog istnieje o takiej samej nazwie jak destinationFileName.
-lub-
Wystąpił problem z we/wy.
Typ wpisu jest nieobsługiwany.
Uprawnienia są niewystarczające.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.
Uwagi
Pliki typu BlockDevice, CharacterDevicelub Fifo można wyodrębnić tylko na platformach Unix.
Podniesienie uprawnień jest wymagane do wyodrębnienia dysku BlockDevice lub CharacterDevice .
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 ExtractToFile(String, Boolean)usługę .
