ZipFile.ExtractToDirectoryAsync Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

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

Aşırı Yüklemeler

Name	Description
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.
ExtractToDirectoryAsync(Stream, String, CancellationToken)	Belirtilen akışta depolanan zip arşivindeki tüm dosyaları zaman uyumsuz olarak ayıklar ve dosya sistemindeki belirtilen hedef dizine yerleştirir.
ExtractToDirectoryAsync(String, String, CancellationToken)	Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.
ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	Zaman uyumsuz olarak, belirtilen akışta depolanan zip arşivindeki tüm dosyaları ayıklar ve bunları dosya sistemindeki belirtilen hedef dizine yerleştirir ve isteğe bağlı olarak hedef dizindeki dosyaların üzerine yazılıp yazılmadığını seçmeye izin verir.
ExtractToDirectoryAsync(Stream, String, Encoding, CancellationToken)	Belirtilen akışta depolanan zip arşivindeki tüm dosyaları zaman uyumsuz olarak ayıklar ve dosya sistemindeki belirtilen hedef dizine yerleştirir ve giriş adları için belirtilen karakter kodlamasını kullanır.
ExtractToDirectoryAsync(String, String, Encoding, CancellationToken)	Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.
ExtractToDirectoryAsync(Stream, String, Encoding, Boolean, CancellationToken)	Belirtilen akışta depolanan zip arşivindeki tüm dosyaları zaman uyumsuz olarak ayıklar ve dosya sistemindeki belirtilen hedef dizine yerleştirir, girdi adları için belirtilen karakter kodlamasını kullanır ve isteğe bağlı olarak hedef dizindeki dosyaların üzerine yazılıp yazılmadığını seçmeye izin verir.
ExtractToDirectoryAsync(String, String, Encoding, Boolean, CancellationToken)	Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar. Belirtilen dizin mevcut olmamalıdır. Bu yöntem tüm alt dizinleri ve belirtilen dizini oluşturur. Arşiv ayıklanırken bir hata varsa, arşiv kısmen ayıklanmış olarak kalır. Ayıklanan dosyanın destinationDirectoryName ile arşive olan göreli yolu aynı olacak şekilde her girdi ayıklanır. Yolun göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır. Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih saat (1 Ocak 1980'de gece yarısı) kullanılır.

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceArchiveFileName

String

Ayıklanacak dosya sistemindeki arşivin yolu.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

overwriteFiles

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

ArgumentException

sourceArchiveFileName veya destinationDirectoryName 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.

ArgumentNullException

sourceArchiveFileName veya destinationDirectoryName şeklindedir null.

PathTooLongException

sourceArchiveFileName veya destinationDirectoryName sistem tarafından tanımlanan uzunluk üst sınırını aşan bir yol, dosya adı veya her ikisini de belirtir. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden az, dosya adları ise 260 karakterden kısa olmalıdır.

DirectoryNotFoundException

veya sourceArchiveFileName tarafından destinationDirectoryName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

IOException

G/Ç hatası oluştu.

-veya-

Arşiv girdilerinin adı sıfır uzunlukta, yalnızca boşluk içeriyor veya InvalidPathChars tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor.

-veya-

Arşiv girdisinin ayıklanması, hedef dizinin dışındaki bir dosya hedefine (örneğin, üst dizin erişimcileri nedeniyle) neden olabilir.

-veya-

Arşiv girdisi, aynı arşivden ayıklanmış bir girdiyle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

NotSupportedException

sourceArchiveFileName veya destinationDirectoryName geçersiz biçimde.

FileNotFoundException

sourceArchiveFileName bulunamadı.

InvalidDataException

sourceArchiveFileName geçerli bir ZipArchive değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Belirtilen dizin mevcut olmamalıdır. Bu yöntem tüm alt dizinleri ve belirtilen dizini oluşturur.

Arşiv ayıklanırken bir hata varsa, arşiv kısmen ayıklanmış olarak kalır. Her girdi, ayıklanan dosyanın arşive giden girişle aynı göreli yoluna destinationDirectoryName sahip olacak şekilde ayıklanır. Yol göreli veya mutlak yol bilgilerini kabul eder; göreli yollar geçerli çalışma dizinine göre yorumlanır.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(Stream, String, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Belirtilen akışta depolanan zip arşivindeki tüm dosyaları zaman uyumsuz olarak ayıklar ve dosya sistemindeki belirtilen hedef dizine yerleştirir.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

source

Stream

Zip arşivinin ayıklandığı akış.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

destinationDirectoryName , Emptyyalnızca boşluk içerir veya en az bir geçersiz karakter içerir.

ArgumentNullException

destinationDirectoryName veya source şeklindedir null.

PathTooLongException

içinde destinationDirectoryName belirtilen yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Arşivdeki bir girdinin adı, Emptyyalnızca boşluk içeriyor veya en az bir geçersiz karakter içeriyor.

-veya-

Arşiv girdisi ayıklandığında, tarafından destinationDirectoryNamebelirtilen dizinin dışında bir dosya oluşturulur. (Örneğin, giriş adı üst dizin erişimcileri içeriyorsa bu durum oluşabilir.)

-veya-

Ayıklanan bir arşiv girdisi, zaten ayıklanmış veya içinde destinationDirectoryNamevar olan bir girişle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın arşive veya hedef dizine erişmek için gerekli izni yok.

NotSupportedException

destinationDirectoryName geçersiz bir biçim içeriyor.

InvalidDataException

Akışta source yer alan arşiv geçerli bir zip arşivi değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Bu yöntem, belirtilen dizini ve tüm alt dizinleri oluşturur. Hedef dizin zaten var olamaz. parametrelerinde yer alan destinationDirectoryName zip arşivindeki veya dosyalarındaki source yolları doğrulamayla ilgili özel durumlar ayıklamadan önce oluşturulur. Aksi takdirde, ayıklama sırasında bir hata oluşursa arşiv kısmen ayıklanmış olarak kalır. Ayıklanan her dosya, tarafından belirtilen destinationDirectoryName dizinin kaynak girdisinin arşivin köküyle aynı göreli yola sahiptir.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(String, String, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceArchiveFileName

String

Ayıklanacak dosya sistemindeki arşivin yolu.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

sourceArchiveFileName veya destinationDirectoryName 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.

ArgumentNullException

sourceArchiveFileName veya destinationDirectoryName şeklindedir null.

PathTooLongException

sourceArchiveFileName veya destinationDirectoryName sistem tarafından tanımlanan uzunluk üst sınırını aşan bir yol, dosya adı veya her ikisini de belirtir. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden az, dosya adları ise 260 karakterden kısa olmalıdır.

DirectoryNotFoundException

veya sourceArchiveFileName tarafından destinationDirectoryName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

IOException

G/Ç hatası oluştu.

-veya-

Arşiv girdilerinin adı sıfır uzunlukta, yalnızca boşluk içeriyor veya InvalidPathChars tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor.

-veya-

Arşiv girdisinin ayıklanması, hedef dizinin dışındaki bir dosya hedefine (örneğin, üst dizin erişimcileri nedeniyle) neden olabilir.

-veya-

Arşiv girdisi, aynı arşivden ayıklanmış bir girdiyle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

NotSupportedException

sourceArchiveFileName veya destinationDirectoryName geçersiz biçimde.

FileNotFoundException

sourceArchiveFileName bulunamadı.

InvalidDataException

tarafından sourceArchiveFileName belirtilen arşiv geçerli bir ZipArchive değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Belirtilen dizin mevcut olmamalıdır. Bu yöntem tüm alt dizinleri ve belirtilen dizini oluşturur.

Arşiv ayıklanırken bir hata varsa, arşiv kısmen ayıklanmış olarak kalır. Her girdi, ayıklanan dosyanın arşive giden girişle aynı göreli yoluna destinationDirectoryName sahip olacak şekilde ayıklanır. Yol göreli veya mutlak yol bilgilerini kabul eder; göreli yollar geçerli çalışma dizinine göre yorumlanır.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Zaman uyumsuz olarak, belirtilen akışta depolanan zip arşivindeki tüm dosyaları ayıklar ve bunları dosya sistemindeki belirtilen hedef dizine yerleştirir ve isteğe bağlı olarak hedef dizindeki dosyaların üzerine yazılıp yazılmadığını seçmeye izin verir.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

source

Stream

Zip arşivinin ayıklandığı akış.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

overwriteFiles

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

ArgumentException

destinationDirectoryName , Emptyyalnızca boşluk içerir veya en az bir geçersiz karakter içerir.

ArgumentNullException

destinationDirectoryName veya source şeklindedir null.

PathTooLongException

içinde destinationDirectoryName belirtilen yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Arşivdeki bir girdinin adı, Emptyyalnızca boşluk içeriyor veya en az bir geçersiz karakter içeriyor.

-veya-

Arşiv girdisi ayıklandığında, tarafından destinationDirectoryNamebelirtilen dizinin dışında bir dosya oluşturulur. (Örneğin, giriş adı üst dizin erişimcileri içeriyorsa bu durum oluşabilir.)

-veya-

overwriteFiles is false ve ayıklanan bir arşiv girdisi, zaten ayıklanmış veya içinde destinationDirectoryNamevar olan bir girişle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın arşive veya hedef dizine erişmek için gerekli izni yok.

NotSupportedException

destinationDirectoryName geçersiz bir biçim içeriyor.

InvalidDataException

Akışta source yer alan arşiv geçerli bir zip arşivi değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Bu yöntem, belirtilen dizini ve tüm alt dizinleri oluşturur. Hedef dizin zaten var olamaz. parametrelerinde yer alan destinationDirectoryName zip arşivindeki veya dosyalarındaki source yolları doğrulamayla ilgili özel durumlar ayıklamadan önce oluşturulur. Aksi takdirde, ayıklama sırasında bir hata oluşursa arşiv kısmen ayıklanmış olarak kalır. Ayıklanan her dosya, tarafından belirtilen destinationDirectoryName dizinin kaynak girdisinin arşivin köküyle aynı göreli yola sahiptir.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(Stream, String, Encoding, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Belirtilen akışta depolanan zip arşivindeki tüm dosyaları zaman uyumsuz olarak ayıklar ve dosya sistemindeki belirtilen hedef dizine yerleştirir ve giriş adları için belirtilen karakter kodlamasını kullanır.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

source

Stream

Zip arşivinin ayıklandığı akış.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

entryNameEncoding

Encoding

Bu arşivde girdi adlarını ve açıklamalarını okurken veya yazarken kullanılacak kodlama. Bu parametre için yalnızca giriş adları veya açıklamaları için UTF-8 kodlamasını desteklemeyen zip arşiv araçları ve kitaplıklarıyla birlikte çalışabilirlik için bir kodlama gerektiğinde bir değer belirtin.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

destinationDirectoryName , Emptyyalnızca boşluk içerir veya en az bir geçersiz karakter içerir.

-veya-

entryNameEncoding UTF-8 dışında bir Unicode kodlamasına ayarlanır.

ArgumentNullException

destinationDirectoryName veya source şeklindedir null.

PathTooLongException

içinde destinationDirectoryName belirtilen yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Arşivdeki bir girdinin adı, Emptyyalnızca boşluk içeriyor veya en az bir geçersiz karakter içeriyor.

-veya-

Arşiv girdisi ayıklandığında, tarafından destinationDirectoryNamebelirtilen dizinin dışında bir dosya oluşturulur. (Örneğin, giriş adı üst dizin erişimcileri içeriyorsa bu durum oluşabilir.)

-veya-

Ayıklanan bir arşiv girdisi, zaten ayıklanmış veya içinde destinationDirectoryNamevar olan bir girişle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın arşive veya hedef dizine erişmek için gerekli izni yok.

NotSupportedException

destinationDirectoryName geçersiz bir biçim içeriyor.

InvalidDataException

Akışta source yer alan arşiv geçerli bir zip arşivi değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Bu yöntem, belirtilen dizini ve tüm alt dizinleri oluşturur. Hedef dizin zaten var olamaz. parametrelerinde yer alan destinationDirectoryName zip arşivindeki veya dosyalarındaki source yolları doğrulamayla ilgili özel durumlar ayıklamadan önce oluşturulur. Aksi takdirde, ayıklama sırasında bir hata oluşursa arşiv kısmen ayıklanmış olarak kalır. Ayıklanan her dosya, tarafından belirtilen destinationDirectoryName dizinin kaynak girdisinin arşivin köküyle aynı göreli yola sahiptir.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(String, String, Encoding, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceArchiveFileName

String

Ayıklanacak dosya sistemindeki arşivin yolu.

destinationDirectoryName

String

Dosya sistemindeki dizinin yolu. Belirtilen dizin mevcut olmamalıdır, ancak içinde bulunduğu dizin bulunmalıdır.

entryNameEncoding

Encoding

Bu ZipArchive'de giriş adlarını ve açıklamalarını okurken veya yazarken kullanılacak kodlama.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

sourceArchiveFileName veya destinationDirectoryName 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.

ArgumentNullException

sourceArchiveFileName veya destinationDirectoryName şeklindedir null.

PathTooLongException

sourceArchiveFileName veya destinationDirectoryName sistem tarafından tanımlanan uzunluk üst sınırını aşan bir yol, dosya adı veya her ikisini de belirtir. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden az, dosya adları ise 260 karakterden kısa olmalıdır.

DirectoryNotFoundException

veya sourceArchiveFileName tarafından destinationDirectoryName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

IOException

G/Ç hatası oluştu.

-veya-

Arşiv girdilerinin adı sıfır uzunlukta, yalnızca boşluk içeriyor veya InvalidPathChars tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor.

-veya-

Arşiv girdisinin ayıklanması, hedef dizinin dışındaki bir dosya hedefine (örneğin, üst dizin erişimcileri nedeniyle) neden olabilir.

-veya-

Arşiv girdisi, aynı arşivden ayıklanmış bir girdiyle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

NotSupportedException

sourceArchiveFileName veya destinationDirectoryName geçersiz biçimde.

FileNotFoundException

sourceArchiveFileName bulunamadı.

InvalidDataException

tarafından sourceArchiveFileName belirtilen arşiv geçerli bir ZipArchive değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Belirtilen dizin mevcut olmamalıdır. Bu yöntem tüm alt dizinleri ve belirtilen dizini oluşturur.

Arşiv ayıklanırken bir hata varsa, arşiv kısmen ayıklanmış olarak kalır. Her girdi, ayıklanan dosyanın arşive giden girişle aynı göreli yoluna destinationDirectoryName sahip olacak şekilde ayıklanır. Yol göreli veya mutlak yol bilgilerini kabul eder; göreli yollar geçerli çalışma dizinine göre yorumlanır.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

dışında entryNameEncodingbir değere ayarlanırsanull, giriş adları ve açıklamaları aşağıdaki kurallara göre çözülecek:

• Yerel dosya üst bilgisinin genel amaçlı bit bayrağındaki dil kodlama bayrağının (EFS) ayarlanmadığı girişler için, girdi adı ve açıklamasının kodunu çözmek için belirtilen entryNameEncoding değerini kullanın.
• Yerel dosya üst bilgisinin genel amaçlı bit bayrağında dil kodlama bayrağının (EFS) ayarlandığı girişler için, girdi adı ve açıklamasının kodunu çözmek için UTF-8 (Encoding.UTF8) kullanın.

olarak ayarlanırsa entryNameEncodingnull, giriş adları ve açıklamaları aşağıdaki kurallara göre çözülecek:

• Yerel dosya üst bilgisinin genel amaçlı bit bayrağında dil kodlama bayrağının (EFS) ayarlanmadığı girişler için, giriş adı ve açıklamasının kodunu çözmek için geçerli sistem varsayılan kod sayfasını (Encoding.Default) kullanın.
• Yerel dosya üst bilgisinin genel amaçlı bit bayrağında dil kodlama bayrağının (EFS) ayarlandığı girişler için, girdi adı ve açıklamasının kodunu çözmek için UTF-8 (Encoding.UTF8) kullanın.

UTF-8 dışındaki Unicode kodlamaları için entryNameEncodingkullanılamaz, aksi takdirde bir ArgumentException oluşturulur.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(Stream, String, Encoding, Boolean, CancellationToken)

Kaynak:

ZipFile.Create.cs

Belirtilen akışta depolanan zip arşivindeki tüm dosyaları zaman uyumsuz olarak ayıklar ve dosya sistemindeki belirtilen hedef dizine yerleştirir, girdi adları için belirtilen karakter kodlamasını kullanır ve isteğe bağlı olarak hedef dizindeki dosyaların üzerine yazılıp yazılmadığını seçmeye izin verir.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * System.Text.Encoding * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

source

Stream

Zip arşivinin ayıklandığı akış.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

entryNameEncoding

Encoding

Bu arşivde girdi adlarını ve açıklamalarını okurken veya yazarken kullanılacak kodlama. Bu parametre için yalnızca giriş adları veya açıklamaları için UTF-8 kodlamasını desteklemeyen zip arşiv araçları ve kitaplıklarıyla birlikte çalışabilirlik için bir kodlama gerektiğinde bir değer belirtin.

overwriteFiles

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

ArgumentException

destinationDirectoryName , Emptyyalnızca boşluk içerir veya en az bir geçersiz karakter içerir.

-veya-

entryNameEncoding UTF-8 dışında bir Unicode kodlamasına ayarlanır.

ArgumentNullException

destinationDirectoryName veya source şeklindedir null.

PathTooLongException

içinde destinationDirectoryName belirtilen yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Arşivdeki bir girdinin adı, Emptyyalnızca boşluk içeriyor veya en az bir geçersiz karakter içeriyor.

-veya-

Arşiv girdisi ayıklandığında, tarafından destinationDirectoryNamebelirtilen dizinin dışında bir dosya oluşturulur. (Örneğin, giriş adı üst dizin erişimcileri içeriyorsa bu durum oluşabilir.)

-veya-

overwriteFiles is false ve ayıklanan bir arşiv girdisi, zaten ayıklanmış veya içinde destinationDirectoryNamevar olan bir girişle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın arşive veya hedef dizine erişmek için gerekli izni yok.

NotSupportedException

destinationDirectoryName geçersiz bir biçim içeriyor.

InvalidDataException

Akışta source yer alan arşiv geçerli bir zip arşivi değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Bu yöntem, belirtilen dizini ve tüm alt dizinleri oluşturur. Hedef dizin zaten var olamaz. parametrelerinde yer alan destinationDirectoryName zip arşivindeki veya dosyalarındaki source yolları doğrulamayla ilgili özel durumlar ayıklamadan önce oluşturulur. Aksi takdirde, ayıklama sırasında bir hata oluşursa arşiv kısmen ayıklanmış olarak kalır. Ayıklanan her dosya, tarafından belirtilen destinationDirectoryName dizinin kaynak girdisinin arşivin köküyle aynı göreli yola sahiptir.

Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih ve saat (1 Ocak 1980'de gece yarısı) kullanılır.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.

ExtractToDirectoryAsync(String, String, Encoding, Boolean, CancellationToken)

Kaynak:

ZipFile.Extract.Async.cs

Belirtilen arşivdeki tüm dosyaları zaman uyumsuz olarak dosya sistemindeki bir dizine ayıklar.

Belirtilen dizin mevcut olmamalıdır. Bu yöntem tüm alt dizinleri ve belirtilen dizini oluşturur.

Arşiv ayıklanırken bir hata varsa, arşiv kısmen ayıklanmış olarak kalır. Ayıklanan dosyanın destinationDirectoryName ile arşive olan göreli yolu aynı olacak şekilde her girdi ayıklanır. Yolun göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır. Arşivlenecek bir dosyanın son değiştirme zamanı geçersizse, zip zaman damgası biçiminde gösterilebilen ilk tarih saat (1 Ocak 1980'de gece yarısı) kullanılır.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * System.Text.Encoding * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceArchiveFileName

String

Ayıklanacak dosya sistemindeki arşivin yolu.

destinationDirectoryName

String

Göreli veya mutlak yol olarak belirtilen ayıklanan dosyaların yerleştirildiği dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

entryNameEncoding

Encoding

Bu ZipArchive'de giriş adlarını ve açıklamalarını okurken veya yazarken kullanılacak kodlama.

overwriteFiles

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

ArgumentException

sourceArchiveFileName veya destinationDirectoryName 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.

ArgumentNullException

sourceArchiveFileName veya destinationDirectoryName şeklindedir null.

PathTooLongException

sourceArchiveFileName veya destinationDirectoryName sistem tarafından tanımlanan uzunluk üst sınırını aşan bir yol, dosya adı veya her ikisini de belirtir. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden az, dosya adları ise 260 karakterden kısa olmalıdır.

DirectoryNotFoundException

veya sourceArchiveFileName tarafından destinationDirectoryName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

IOException

G/Ç hatası oluştu.

-veya-

Arşiv girdilerinin adı sıfır uzunlukta, yalnızca boşluk içeriyor veya InvalidPathChars tarafından tanımlanan bir veya daha fazla geçersiz karakter içeriyor.

-veya-

Arşiv girdisinin ayıklanması, hedef dizinin dışındaki bir dosya hedefine (örneğin, üst dizin erişimcileri nedeniyle) neden olabilir.

-veya-

Arşiv girdisi, aynı arşivden ayıklanmış bir girdiyle aynı ada sahiptir.

UnauthorizedAccessException

Çağıranın gerekli izni yok.

NotSupportedException

sourceArchiveFileName veya destinationDirectoryName geçersiz biçimde.

FileNotFoundException

sourceArchiveFileName bulunamadı.

InvalidDataException

tarafından sourceArchiveFileName belirtilen arşiv geçerli bir ZipArchive değil.

-veya-

Arşiv girdisi bulunamadı veya bozuk.

-veya-

Arşiv girdisi desteklenmeyen bir sıkıştırma yöntemi kullanılarak sıkıştırıldı.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

dışında entryNameEncodingbir değere ayarlanırsanull, giriş adları ve açıklamaları aşağıdaki kurallara göre çözülecek:

• Yerel dosya üst bilgisinin genel amaçlı bit bayrağındaki dil kodlama bayrağının (EFS) ayarlanmadığı girişler için, girdi adı ve açıklamasının kodunu çözmek için belirtilen entryNameEncoding değerini kullanın.
• Yerel dosya üst bilgisinin genel amaçlı bit bayrağında dil kodlama bayrağının (EFS) ayarlandığı girişler için, girdi adı ve açıklamasının kodunu çözmek için UTF-8 (Encoding.UTF8) kullanın.

olarak ayarlanırsa entryNameEncodingnull, giriş adları ve açıklamaları aşağıdaki kurallara göre çözülecek:

• Yerel dosya üst bilgisinin genel amaçlı bit bayrağında dil kodlama bayrağının (EFS) ayarlanmadığı girişler için, giriş adı ve açıklamasının kodunu çözmek için geçerli sistem varsayılan kod sayfasını (Encoding.Default) kullanın.
• Yerel dosya üst bilgisinin genel amaçlı bit bayrağında dil kodlama bayrağının (EFS) ayarlandığı girişler için, girdi adı ve açıklamasının kodunu çözmek için UTF-8 (Encoding.UTF8) kullanın.

UTF-8 dışındaki Unicode kodlamaları için entryNameEncodingkullanılamaz, aksi takdirde bir ArgumentException oluşturulur.

Warning

Bu yöntem, toplam sıkıştırılmamış boyutu veya arşivden ayıklanan girdi sayısını sınırlamaz. Güvenilmeyen kaynaklardan gelen arşivleri işlerken, kullanarak ZipArchivegirdileri el ile yineleyip toplam sıkıştırılmamış boyutun ve girdi sayısının senaryonuz için kabul edilebilir sınırlar içinde olduğunu doğrulayın.