ZipFileExtensions.CreateEntryFromFileAsync Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Dosya sisteminden belirtilen giriş adı altındaki arşive zaman uyumsuz olarak bir dosya ekler.
Aşırı Yüklemeler
| Name | Description |
|---|---|
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Dosya sisteminden belirtilen giriş adı altındaki arşive zaman uyumsuz olarak bir dosya ekler. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Dosya sisteminden belirtilen giriş adı altındaki arşive zaman uyumsuz olarak bir dosya ekler. |
CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken)
Dosya sisteminden belirtilen giriş adı altındaki arşive zaman uyumsuz olarak bir dosya ekler.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parametreler
- destination
- ZipArchive
Dosyanın ekleneceği zip arşivi.
- sourceFileName
- String
Kopyalanacak dosya sistemindeki dosyanın yolu. Yolun göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır.
- entryName
- String
Oluşturulacak girişin adı.
- cancellationToken
- CancellationToken
İptal isteklerini izlemek için iptal belirteci.
Döndürülenler
Yeni oluşturulan girdi için sarmalayıcı.
Özel durumlar
sourceFileName 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-
entryName sıfır uzunluklu bir dizedir.
sourceFileName veya entryName şeklindedir null.
içinde sourceFileName, 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.
Belirtilen sourceFileName geçersiz (örneğin, eşlenmemiş bir sürücüde).
tarafından sourceFileNamebelirtilen dosya açılırken G/Ç hatası oluştu.
içinde sourceFileName belirtilen dosya bulunamadı.
sourceFileName geçersiz bir biçimde veya ZipArchive yazmayı desteklemiyor.
ZipArchive zaten kapatıldı.
Zaman uyumsuz bir işlem iptal edildi.
Açıklamalar
Arşivdeki yeni girdi dosyanın içeriğini içerir.
Arşiv girdisinin son yazma zamanı, dosya sistemindeki dosyanın son yazma zamanına ayarlanır.
Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur.
Belirtilen kaynak dosyanın son değiştirme zamanı geçersizse, Zip zaman damgası biçiminde temsil edilebilen ilk tarih saat (1 Ocak 1980 gece yarısı) 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.)
Şunlara uygulanır
CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken)
Dosya sisteminden belirtilen giriş adı altındaki arşive zaman uyumsuz olarak bir dosya ekler.
public static System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry> CreateEntryFromFileAsync(this System.IO.Compression.ZipArchive destination, string sourceFileName, string entryName, System.IO.Compression.CompressionLevel compressionLevel, System.Threading.CancellationToken cancellationToken = default);static member CreateEntryFromFileAsync : System.IO.Compression.ZipArchive * string * string * System.IO.Compression.CompressionLevel * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.IO.Compression.ZipArchiveEntry><Extension()>
Public Function CreateEntryFromFileAsync (destination As ZipArchive, sourceFileName As String, entryName As String, compressionLevel As CompressionLevel, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ZipArchiveEntry)Parametreler
- destination
- ZipArchive
Dosyanın ekleneceği zip arşivi.
- sourceFileName
- String
Kopyalanacak dosya sistemindeki dosyanın yolu. Yolun göreli veya mutlak yol bilgilerini belirtmesine izin verilir. Göreli yol bilgileri geçerli çalışma dizinine göre yorumlanır.
- entryName
- String
Oluşturulacak girişin adı.
- compressionLevel
- CompressionLevel
Sıkıştırma düzeyi (hız/bellek ve sıkıştırılmış boyut dengelemesi).
- cancellationToken
- CancellationToken
İptal isteklerini izlemek için iptal belirteci.
Döndürülenler
Yeni oluşturulan girdi için sarmalayıcı.
Özel durumlar
sourceFileName 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-
entryName sıfır uzunluklu bir dizedir.
sourceFileName veya entryName şeklindedir null.
içinde sourceFileName, 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.
Belirtilen sourceFileName geçersiz (örneğin, eşlenmemiş bir sürücüde).
tarafından sourceFileNamebelirtilen dosya açılırken G/Ç hatası oluştu.
içinde sourceFileName belirtilen dosya bulunamadı.
sourceFileName geçersiz bir biçimde veya ZipArchive yazmayı desteklemiyor.
ZipArchive zaten kapatıldı.
Zaman uyumsuz bir işlem iptal edildi.
Açıklamalar
Arşivdeki yeni girdi dosyanın içeriğini içerir.
Arşiv girdisinin son yazma zamanı, dosya sistemindeki dosyanın son yazma zamanına ayarlanır.
Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur.
Belirtilen kaynak dosyanın son değiştirme zamanı geçersizse, Zip zaman damgası biçiminde temsil edilebilen ilk tarih saat (1 Ocak 1980 gece yarısı) kullanılır. Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur.
