ZipFileExtensions.ExtractToFileAsync Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

netstandard.dll, System.IO.Compression.ZipFile.dll

Zaman uyumsuz olarak, girdinin içeriği ve belirtilen adla dosya sisteminde bir dosya oluşturur.

Aşırı Yüklemeler

Name	Description
ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)	Zaman uyumsuz olarak, girdinin içeriği ve belirtilen adla dosya sisteminde bir dosya oluşturur.
ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)	Zaman uyumsuz olarak, girdinin içeriği ve belirtilen adla dosya sisteminde bir dosya oluşturur.

ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken)

Kaynak:

ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Zaman uyumsuz olarak, girdinin içeriği ve belirtilen adla dosya sisteminde bir dosya oluşturur.

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

source

ZipArchiveEntry

Dosyasının ayıklanması için zip arşiv girdisi.

destinationFileName

String

Girdinin içeriğini tutacak dosyanın adı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

UnauthorizedAccessException

Çağıranın gerekli izni yok.

ArgumentException

destinationFileName sıfır uzunluklu bir dizedir, yalnızca boşluk içerir veya InvalidPathChars tarafından tanımlanan bir veya daha fazla geçersiz karakter içerir.

-veya-

destinationFileName bir dizin belirtir.

ArgumentNullException

destinationFileName, null'e eşittir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden az, dosya adları ise 260 karakterden kısa olmalıdır.

DirectoryNotFoundException

içinde destinationFileName belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

G/Ç hatası oluştu.

-veya-

Girdi şu anda yazmak için açık.

-veya-

Girdi arşivden silindi.

NotSupportedException

destinationFileName geçersiz biçimde.

-veya-

Bu girdinin ait olduğu ZipArchive, salt yazma modunda açıldı.

InvalidDataException

Girdi arşivde yok veya bozuk ve okunamıyor.

-veya-

Giriş, desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

ObjectDisposedException

Bu girdinin ait olduğu ZipArchive atılmış.

Açıklamalar

Belirtilen yolun göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır.

Dosyanın son yazma zamanı girdinin son yazma zamanına ayarlanır. Bu yöntem, aynı ada sahip mevcut bir dosyanın üzerine yazılmasına izin vermez. Açık dizinleri ayıklama girişimi (dizin ayırıcı karakterleriyle biten adlara sahip girişler) dizin oluşturulmasıyla sonuçlanmaz.

ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken)

Kaynak:

ZipFileExtensions.ZipArchiveEntry.Extract.Async.cs

Zaman uyumsuz olarak, girdinin içeriği ve belirtilen adla dosya sisteminde bir dosya oluşturur.

public static System.Threading.Tasks.Task ExtractToFileAsync(this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToFileAsync : System.IO.Compression.ZipArchiveEntry * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

<Extension()>
Public Function ExtractToFileAsync (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

source

ZipArchiveEntry

Dosyasının ayıklanması için zip arşiv girdisi.

destinationFileName

String

Girdinin içeriğini tutacak dosyanın adı.

overwrite

Boolean

true dosyaların üzerine yazmak için; false Aksi takdir -de.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

UnauthorizedAccessException

Çağıranın gerekli izni yok.

ArgumentException

destinationFileName sıfır uzunluklu bir dizedir, yalnızca boşluk içerir veya InvalidPathChars tarafından tanımlanan bir veya daha fazla geçersiz karakter içerir.

-veya-

destinationFileName bir dizin belirtir.

ArgumentNullException

destinationFileName, null'e eşittir.

PathTooLongException

Belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden az, dosya adları ise 260 karakterden kısa olmalıdır.

DirectoryNotFoundException

içinde destinationFileName belirtilen yol geçersiz (örneğin, eşlenmemiş bir sürücüde).

IOException

G/Ç hatası oluştu.

-veya-

Girdi şu anda yazmak için açık.

-veya-

Girdi arşivden silindi.

NotSupportedException

destinationFileName geçersiz biçimde.

-veya-

Bu girdinin ait olduğu ZipArchive, salt yazma modunda açıldı.

InvalidDataException

Girdi arşivde yok veya bozuk ve okunamıyor.

-veya-

Giriş, desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

ObjectDisposedException

Bu girdinin ait olduğu ZipArchive atılmış.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Belirtilen yolun göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır.

Dosyanın son yazma zamanı girdinin son yazma zamanına ayarlanır.

Bu yöntem, aynı ada sahip mevcut bir dosyanın üzerine yazılmasına izin verir.