TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) Yöntem

Tanım

Ad Alanı:

System.Formats.Tar

Bütünleştirilmiş Kod:

System.Formats.Tar.dll

Kaynak:

TarEntry.cs

Geçerli girdiyi zaman uyumsuz olarak dosya sistemine ayıklar.

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.Task

Public Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

destinationFileName

String

Hedef dosyanın yolu.

overwrite

Boolean

true bu yöntemin yolda bulunan mevcut dosya sistemi nesnesinin üzerine yazması destinationFileName gerekiyorsa; false üzerine yazmayı önlemek için.

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

Task

Zaman uyumsuz ayıklama işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

destinationFileName, null değeridir.

ArgumentException

destinationFileName boş.

IOException

üst dizini destinationFileName yok.

-veya-

overwrite is false ve içinde zaten bir dosya var destinationFileName.

-veya-

ile aynı ada destinationFileNamesahip bir dizin var.

-veya-

G/Ç sorunu oluştu.

InvalidOperationException

Giriş türü desteklenmiyor.

UnauthorizedAccessException

İzinler yetersiz.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

, CharacterDeviceveya Fifo türündeki BlockDevicedosyalar yalnızca Unix platformlarında ayıklanabilir.

Diske veya CharacterDevice ayıklamak BlockDevice için yükseltme gerekir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ExtractToFile(String, Boolean)özel durumlara bakın.