ZipFile.CreateFromDirectoryAsync Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

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

Belirtilen akışta zaman uyumsuz olarak, belirtilen dizindeki dosyaları ve dizinleri içeren bir zip arşivi oluşturur.

Aşırı Yüklemeler

Name	Description
CreateFromDirectoryAsync(String, String, CompressionLevel, Boolean, Encoding, CancellationToken)	tarafından destinationArchiveFileNamebelirtilen dizindeki dosyaları ve dizinleri içeren yolda sourceDirectoryName zaman uyumsuz olarak bir zip arşivi oluşturur.
CreateFromDirectoryAsync(String, Stream, CompressionLevel, Boolean, Encoding, CancellationToken)	Belirtilen dizindeki dosyaları ve dizinleri içeren belirtilen akışta zaman uyumsuz olarak, girdi adları için belirtilen sıkıştırma düzeyini ve karakter kodlamasını kullanarak ve isteğe bağlı olarak temel dizini içeren bir zip arşivi oluşturur.
CreateFromDirectoryAsync(String, String, CompressionLevel, Boolean, CancellationToken)	tarafından destinationArchiveFileNamebelirtilen dizindeki dosyaları ve dizinleri içeren yolda sourceDirectoryName zaman uyumsuz olarak bir zip arşivi oluşturur.
CreateFromDirectoryAsync(String, Stream, CompressionLevel, Boolean, CancellationToken)	Belirtilen dizindeki dosyaları ve dizinleri içeren belirtilen akışta zaman uyumsuz olarak, belirtilen sıkıştırma düzeyini kullanarak ve isteğe bağlı olarak temel dizini içeren bir zip arşivi oluşturur.
CreateFromDirectoryAsync(String, String, CancellationToken)	tarafından destinationArchiveFileNamebelirtilen dizindeki dosyaları ve dizinleri içeren yolda sourceDirectoryName zaman uyumsuz olarak bir zip arşivi oluşturur.
CreateFromDirectoryAsync(String, Stream, CancellationToken)	Belirtilen akışta zaman uyumsuz olarak, belirtilen dizindeki dosyaları ve dizinleri içeren bir zip arşivi oluşturur.

CreateFromDirectoryAsync(String, String, CompressionLevel, Boolean, Encoding, CancellationToken)

Kaynak:

ZipFile.Create.Async.cs

tarafından destinationArchiveFileNamebelirtilen dizindeki dosyaları ve dizinleri içeren yolda sourceDirectoryName zaman uyumsuz olarak bir zip arşivi oluşturur.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

static member CreateFromDirectoryAsync : string * string * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceDirectoryName

String

Arşivlenecek dosya sistemindeki dizinin yolu.

destinationArchiveFileName

String

Oluşturulacak arşivin adı.

compressionLevel

CompressionLevel

Sıkıştırma düzeyini belirten numaralandırma değerlerinden biri (hız/bellek ve sıkıştırılmış boyut dengeleme).

includeBaseDirectory

Boolean

true adlı bir dizinin sourceDirectoryName arşivin köküne eklenmesi gerektiğini belirtir. false içindeki dosya ve dizinlerin sourceDirectoryName doğrudan arşive eklenmesi gerektiğini belirtmek için.

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

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

ArgumentNullException

sourceDirectoryName veya destinationArchiveFileName şeklindedir null.

PathTooLongException

veya sourceDirectoryNameiçindedestinationArchiveFileName, 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

sourceDirectoryName veya destinationArchiveFileName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

-veya-

tarafından sourceDirectoryName belirtilen dizin yok.

IOException

destinationArchiveFileName zaten var.

-veya-

Arşivlenecek bir dosya açılırken G/Ç hatası oluştu.

UnauthorizedAccessException

destinationArchiveFileName bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

NotSupportedException

sourceDirectoryName veya destinationArchiveFileName geçersiz biçimde.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Dizin yapısı arşivde korunur ve arşivlenecek dosyalar için özyinelemeli bir arama yapılır. Arşiv mevcut olmamalıdır. Dizin boşsa boş bir arşiv oluşturulur.

Dizindeki bir dosya arşive eklenemiyorsa, arşiv eksik ve geçersiz bırakılır ve yöntem bir özel durum oluşturur. Bu yöntem isteğe bağlı olarak arşivdeki temel dizini içerir.

Arşive dosya eklenirken bir hatayla karşılaşılırsa, bu yöntem dosya eklemeyi durdurur ve arşivi geçersiz durumda bırakır. Yolların göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır. Arşivdeki bir dosyanın son yazma zamanı alanında geçerli bir zip zaman damgası olmayan veriler varsa, dosyanın son değiştirme zamanı için gece yarısı 1980 Ocak 1 gösterge değeri kullanılır. Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur. Hayır CompressionLevel belirtilmediğinden, temel sıkıştırma algoritmasının uygulanması tarafından sağlanan varsayılan değer kullanılır; ZipArchive kendi varsayılanını uygulamaz.

(Şu anda temel alınan sıkıştırma algoritması sınıfı tarafından DeflateStream sağlanır.)

dışında entryNameEncoding bir değer null belirtilmesi önerilmez.

Ancak bu, girdi adları veya açıklamalar için UTF-8 kodlamasını doğru şekilde desteklemeyen zip arşiv araçları ve kitaplıklarıyla birlikte çalışabilirlik için gerekli olabilir.

• Belirtilmezse entryNameEncoding (== null):
  • ASCII aralığının dışında karakterler içeren dosya adları veya açıklamalar için:
    Dil kodlama bayrağı (EFS), ilgili girdinin yerel dosya üst bilgisinin genel amaçlı bit bayrağında ayarlanır ve UTF-8 (Encoding.UTF8), girdi adını ve açıklamasını bayt olarak kodlamak için kullanılır.
  • ASCII aralığının dışında karakter içermeyen dosya adları veya açıklamalar için:
    Dil kodlama bayrağı (EFS), ilgili girdinin yerel dosya üst bilgisinin genel amaçlı bit bayrağında ayarlanmaz ve geçerli sistem varsayılan kod sayfası (Encoding.Default) giriş adlarını ve açıklamalarını bayt olarak kodlamak için kullanılır.
• Belirtilirse entryNameEncoding (!= null):
  • Belirtilen entryNameEncoding her zaman giriş adlarını ve açıklamalarını bayt olarak kodlamak için kullanılır.
    Her girdi için yerel dosya üst bilgisinin genel amaçlı bit bayrağındaki dil kodlama bayrağı (EFS), yalnızca belirtilen entryNameEncoding bir UTF-8 kodlaması ise ayarlanır.

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

CreateFromDirectoryAsync(String, Stream, CompressionLevel, Boolean, Encoding, CancellationToken)

Kaynak:

ZipFile.Create.Async.cs

Belirtilen dizindeki dosyaları ve dizinleri içeren belirtilen akışta zaman uyumsuz olarak, girdi adları için belirtilen sıkıştırma düzeyini ve karakter kodlamasını kullanarak ve isteğe bağlı olarak temel dizini içeren bir zip arşivi oluşturur.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceDirectoryName

String

Göreli veya mutlak yol olarak belirtilen, arşivlenecek dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

destination

Stream

Zip arşivinin depolandığı akış.

compressionLevel

CompressionLevel

Girdiyi oluştururken hızın mı yoksa sıkıştırma etkinliğinin mi vurgulanmayacağını gösteren numaralandırma değerlerinden biri.

includeBaseDirectory

Boolean

true dizinin adını arşivin köküne sourceDirectoryName eklemek; false yalnızca dizinin içeriğini eklemek için.

entryNameEncoding

Encoding

Bu arşivde girdi adları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

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

-veya-

Akış destination yazmayı desteklemiyor.

ArgumentNullException

sourceDirectoryName veya destination şeklindedir null.

PathTooLongException

içinde sourceDirectoryName, belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Belirtilen dizindeki bir dosya açılamadı.

-veya-

Arşivlenecek bir dosya açılırken G/Ç hatası oluştu.

NotSupportedException

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

ArgumentOutOfRangeException

compressionLevel geçerli CompressionLevel bir değer değil.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Dosya sisteminden dizin yapısı arşivde korunur. Dizin boşsa boş bir arşiv oluşturulur.

Sıkıştırma düzeyini ve karakter kodlamasını ve temel dizinin arşive eklenip eklenmeyeceğini belirtmek için bu yöntem aşırı yüklemesini kullanın.

Dizindeki bir dosya arşive eklenemiyorsa, arşiv eksik ve geçersiz bırakılır ve yöntem bir IOException özel durum oluşturur.

CreateFromDirectoryAsync(String, String, CompressionLevel, Boolean, CancellationToken)

Kaynak:

ZipFile.Create.Async.cs

tarafından destinationArchiveFileNamebelirtilen dizindeki dosyaları ve dizinleri içeren yolda sourceDirectoryName zaman uyumsuz olarak bir zip arşivi oluşturur.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceDirectoryName

String

Arşivlenecek dosya sistemindeki dizinin yolu.

destinationArchiveFileName

String

Oluşturulacak arşivin adı.

compressionLevel

CompressionLevel

Sıkıştırma düzeyini belirten numaralandırma değerlerinden biri (hız/bellek ve sıkıştırılmış boyut dengeleme).

includeBaseDirectory

Boolean

true adlı bir dizinin sourceDirectoryName arşivin köküne eklenmesi gerektiğini belirtir. false içindeki dosya ve dizinlerin sourceDirectoryName doğrudan arşive eklenmesi gerektiğini belirtmek için.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

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

ArgumentNullException

sourceDirectoryName veya destinationArchiveFileName şeklindedir null.

PathTooLongException

veya sourceDirectoryNameiçindedestinationArchiveFileName, 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

sourceDirectoryName veya destinationArchiveFileName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

-veya-

tarafından sourceDirectoryName belirtilen dizin yok.

IOException

destinationArchiveFileName zaten var.

-veya-

Arşivlenecek bir dosya açılırken G/Ç hatası oluştu.

UnauthorizedAccessException

destinationArchiveFileName bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

NotSupportedException

sourceDirectoryName veya destinationArchiveFileName geçersiz biçimde.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Dizin yapısı arşivde korunur ve arşivlenecek dosyalar için özyinelemeli bir arama yapılır. Arşiv mevcut olmamalıdır. Dizin boşsa boş bir arşiv oluşturulur.

Dizindeki bir dosya arşive eklenemiyorsa, arşiv eksik ve geçersiz bırakılır ve yöntem bir özel durum oluşturur. Bu yöntem isteğe bağlı olarak arşivdeki temel dizini içerir.

Arşive dosya eklenirken bir hatayla karşılaşılırsa, bu yöntem dosya eklemeyi durdurur ve arşivi geçersiz durumda bırakır. Yolların göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır. Arşivdeki bir dosyanın son yazma zamanı alanında geçerli bir zip zaman damgası olmayan veriler varsa, dosyanın son değiştirme zamanı için gece yarısı 1980 Ocak 1 gösterge değeri kullanılır. Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur. Hayır CompressionLevel belirtilmediğinden, temel sıkıştırma algoritmasının uygulanması tarafından sağlanan varsayılan değer kullanılır; ZipArchive kendi varsayılanını uygulamaz.

(Şu anda temel alınan sıkıştırma algoritması sınıfı tarafından DeflateStream sağlanır.)

CreateFromDirectoryAsync(String, Stream, CompressionLevel, Boolean, CancellationToken)

Kaynak:

ZipFile.Create.Async.cs

Belirtilen dizindeki dosyaları ve dizinleri içeren belirtilen akışta zaman uyumsuz olarak, belirtilen sıkıştırma düzeyini kullanarak ve isteğe bağlı olarak temel dizini içeren bir zip arşivi oluşturur.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceDirectoryName

String

Göreli veya mutlak yol olarak belirtilen, arşivlenecek dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

destination

Stream

Zip arşivinin depolandığı akış.

compressionLevel

CompressionLevel

Girdiyi oluştururken hızın mı yoksa sıkıştırma etkinliğinin mi vurgulanmayacağını gösteren numaralandırma değerlerinden biri.

includeBaseDirectory

Boolean

true dizinin adını arşivin köküne sourceDirectoryName eklemek; false yalnızca dizinin içeriğini eklemek için.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

Task

Özel durumlar

ArgumentException

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

-veya-

Akış destination yazmayı desteklemiyor.

ArgumentNullException

sourceDirectoryName veya destination şeklindedir null.

PathTooLongException

içinde sourceDirectoryName, belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Belirtilen dizindeki bir dosya açılamadı.

-veya-

Arşivlenecek bir dosya açılırken G/Ç hatası oluştu.

NotSupportedException

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

ArgumentOutOfRangeException

compressionLevel geçerli CompressionLevel bir değer değil.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Dosya sisteminden dizin yapısı arşivde korunur. Dizin boşsa boş bir arşiv oluşturulur.

Sıkıştırma düzeyini ve temel dizinin arşive eklenip eklenmeyeceğini belirtmek için bu yöntem aşırı yüklemesini kullanın.

Dizindeki bir dosya arşive eklenemiyorsa, arşiv eksik ve geçersiz bırakılır ve yöntem bir IOException özel durum oluşturur.

CreateFromDirectoryAsync(String, String, CancellationToken)

Kaynak:

ZipFile.Create.Async.cs

tarafından destinationArchiveFileNamebelirtilen dizindeki dosyaları ve dizinleri içeren yolda sourceDirectoryName zaman uyumsuz olarak bir zip arşivi oluşturur.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, string destinationArchiveFileName, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationArchiveFileName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceDirectoryName

String

Arşivlenecek dosya sistemindeki dizinin yolu.

destinationArchiveFileName

String

Oluşturulacak arşivin adı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

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

ArgumentNullException

sourceDirectoryName veya destinationArchiveFileName şeklindedir null.

PathTooLongException

veya sourceDirectoryNameiçindedestinationArchiveFileName, 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

sourceDirectoryName veya destinationArchiveFileName belirtilen yol geçersizdir (örneğin, eşlenmemiş bir sürücüdedir).

-veya-

tarafından sourceDirectoryName belirtilen dizin yok.

IOException

destinationArchiveFileName zaten var.

-veya-

Arşivlenecek bir dosya açılırken G/Ç hatası oluştu.

UnauthorizedAccessException

destinationArchiveFileName bir dizin belirtti.

-veya-

Çağıranın gerekli izni yok.

NotSupportedException

sourceDirectoryName veya destinationArchiveFileName geçersiz biçimde.

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Dizin yapısı arşivde korunur ve arşivlenecek dosyalar için özyinelemeli bir arama yapılır. Arşiv mevcut olmamalıdır. Dizin boşsa boş bir arşiv oluşturulur. Dizindeki bir dosya arşive eklenemiyorsa, arşiv eksik ve geçersiz bırakılır ve yöntem bir özel durum oluşturur. Bu yöntem arşive temel dizini içermez.

Arşive dosya eklenirken hatayla karşılaşılırsa, bu yöntem dosya eklemeyi durdurur ve arşivi geçersiz durumda bırakır. Yolların göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır. Arşivdeki bir dosyanın son yazma zamanı alanında geçerli bir zip zaman damgası olmayan veriler varsa, dosyanın son değiştirme zamanı için gece yarısı 1980 Ocak 1 gösterge değeri kullanılır. Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur. Hayır CompressionLevel belirtilmediğinden, temel sıkıştırma algoritmasının uygulanması tarafından sağlanan varsayılan değer kullanılır; ZipArchive kendi varsayılanını uygulamaz.

(Şu anda temel alınan sıkıştırma algoritması sınıfı tarafından DeflateStream sağlanır.)

CreateFromDirectoryAsync(String, Stream, CancellationToken)

Kaynak:

ZipFile.Create.Async.cs

Belirtilen akışta zaman uyumsuz olarak, belirtilen dizindeki dosyaları ve dizinleri içeren bir zip arşivi oluşturur.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync(string sourceDirectoryName, System.IO.Stream destination, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

sourceDirectoryName

String

Göreli veya mutlak yol olarak belirtilen, arşivlenecek dizinin yolu. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

destination

Stream

Zip arşivinin depolandığı akış.

cancellationToken

CancellationToken

İptal isteklerini izlemek için iptal belirteci.

Döndürülenler

Task

Özel durumlar

ArgumentException

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

-veya-

Akış destination yazmayı desteklemiyor.

ArgumentNullException

sourceDirectoryName veya destination şeklindedir null.

PathTooLongException

içinde sourceDirectoryName, belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

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

IOException

Belirtilen dizindeki bir dosya açılamadı.

-veya-

Arşivlenecek bir dosya açılırken G/Ç hatası oluştu.

NotSupportedException

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

OperationCanceledException

Zaman uyumsuz bir işlem iptal edildi.

Açıklamalar

Dosya sisteminden dizin yapısı arşivde korunur. Dizin boşsa boş bir arşiv oluşturulur.

Bu yöntem aşırı yüklemesi arşivdeki temel dizini içermez ve sıkıştırma düzeyi belirtmenize izin vermez.

Temel dizini eklemek veya sıkıştırma düzeyi belirtmek istiyorsanız yöntem aşırı yüklemesini çağırın CreateFromDirectory(String, Stream, CompressionLevel, Boolean) .

Dizindeki bir dosya arşive eklenemiyorsa, arşiv eksik ve geçersiz bırakılır ve yöntem bir IOException özel durum oluşturur.