Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Bu sınıf Z (sıkıştırma) arşiv dosyasını temsil eder. Z arşivlerini oluşturmak veya çıkarmak için kullanın.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
Miras
Uygulamalar
IArchive, IDisposable, IArchiveFileEntry
Miras Alınan Üyeler
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Açıklamalar
https://docs.fileformat.com/compression/z/ adresine bakın.
Yapıcılar
ZArchive()
Sıkıştırma için hazırlanan Aspose.Zip.Z.ZArchive sınıfının yeni bir örneğini başlatır.
public ZArchive()
ZArchive(Stream, ZArchiveLoadOptions)
Açma için hazırlanan Aspose.Zip.Z.ZArchive sınıfının yeni bir örneğini başlatır.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parametreler
source
Stream
Arşivin kaynağı.
loadOptions
ZArchiveLoadOptions
Arşivi yüklemek için kullanılacak seçenekler.
Açıklamalar
Bu yapıcı açma işlemi yapmaz. Açma için Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) yöntemine bakın.
İstisnalar
source
erişilebilir değil.
source
null.
ZArchive(string, ZArchiveLoadOptions)
Açma için hazırlanan Aspose.Zip.Z.ZArchive sınıfının yeni bir örneğini başlatır.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parametreler
path
string
Arşivin kaynağına giden yol.
loadOptions
ZArchiveLoadOptions
Arşivi yüklemek için kullanılacak seçenekler.
Açıklamalar
Bu yapıcı açma işlemi yapmaz. Açma için Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) yöntemine bakın.
İstisnalar
path
null.
Çağrıcı gerekli izne sahip değil.
path
boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.
path
dosyasına erişim reddedildi.
Belirtilen path
, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
path
dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.
Dosya bulunamadı.
Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde bulunuyor.
Dosya zaten açık.
Yöntemler
Dispose()
Yönetilmeyen kaynakların serbest bırakılması, boşaltılması veya sıfırlanması ile ilişkili uygulama tanımlı görevleri yerine getirir.
public void Dispose()
Dispose(bool)
Yönetilmeyen kaynakların serbest bırakılması, boşaltılması veya sıfırlanması ile ilişkili uygulama tanımlı görevleri yerine getirir.
protected virtual void Dispose(bool disposing)
Parametreler
disposing
bool
Yönetilen kaynakların boşaltılıp boşaltılmayacağını belirtir.
Extract(Stream)
Z arşivini bir akışa çıkarır.
public void Extract(Stream destination)
Parametreler
destination
Stream
Açılmış verileri depolamak için akış.
Örnekler
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}
İstisnalar
Veri çıkarılamaz.
Extract(FileInfo)
Z arşivini bir dosyaya çıkarır.
public void Extract(FileInfo fileInfo)
Parametreler
fileInfo
FileInfo
Açılmış verileri depolamak için FileInfo.
Örnekler
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
İstisnalar
Çağrıcı gerekli izne sahip değil.
Dosya yolu boş veya yalnızca boşluk içeriyor.
Dosya bulunamadı.
Dosya yolu yalnızca okunabilir veya bir dizin.
fileInfo
null.
Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde bulunuyor.
Dosya zaten açık.
Veri çıkarılamaz.
Extract(string)
Z arşivini bir dosyaya yol ile çıkarır.
public FileInfo Extract(string path)
Parametreler
path
string
Açılmış verileri depolayacak dosyanın yolu.
Dönüşler
Çıkarılan dosyanın bilgisi.
Örnekler
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
İstisnalar
path
null.
Çağrıcı gerekli izne sahip değil.
path
boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.
path
dosyasına erişim reddedildi.
Belirtilen path
, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
path
dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.
Veri çıkarılamaz.
ExtractToDirectory(string)
Arşiv içeriğini sağlanan dizine çıkarır.
public void ExtractToDirectory(string destinationDirectory)
Parametreler
destinationDirectory
string
Çıkarılan dosyaların yerleştirileceği dizinin yolu.
Açıklamalar
Dizin mevcut değilse, oluşturulacaktır.
İstisnalar
destinationDirectory
null.
Belirtilen yol, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
Çağrıcı mevcut dizine erişim için gerekli izne sahip değil.
Dizin mevcut değilse, yol bir sürücü etiketi (“C:") parçası olmayan bir iki nokta üst üste (:) içeriyor.
destinationDirectory
sıfır uzunluğunda bir dize, yalnızca boşluk içeriyor veya bir veya daha fazla geçersiz karakter içeriyor. Geçersiz karakterleri System.IO.Path.GetInvalidPathChars yöntemi ile sorgulayabilirsiniz.
-veya- yol yalnızca iki nokta üst üste (:) ile başlıyorsa veya içeriyorsa.
Belirtilen yol bir dosyadır. -veya- Ağ adı bilinmiyor.
Save(Stream, ZArchiveSaveOptions)
Xz arşivini sağlanan akışa kaydeder.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parametreler
output
Stream
Hedef akış.
settings
ZArchiveSaveOptions
Arşiv oluşturma için isteğe bağlı ayarlar.
Örnekler
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Açıklamalar
output
erişilebilir olmalıdır.
İstisnalar
output
erişim desteklemiyor.
output
null.
Save(string, ZArchiveSaveOptions)
Z arşivini sağlanan hedef dosyaya kaydeder.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Parametreler
destinationFileName
string
+Oluşturulacak arşivin yolu. Belirtilen dosya adı mevcut bir dosyaya işaret ediyorsa, üzerine yazılacaktır.
settings
ZArchiveSaveOptions
Arşiv oluşturma için isteğe bağlı ayarlar.
Örnekler
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
İstisnalar
destinationFileName
null.
Çağrıcı gerekli izne sahip değil.
destinationFileName
boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.
destinationFileName
dosyasına erişim reddedildi.
Belirtilen destinationFileName
, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
destinationFileName
dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.
SetSource(Stream)
Arşiv içinde sıkıştırılacak içeriği ayarlar.
public void SetSource(Stream source)
Parametreler
source
Stream
Arşiv için giriş akışı.
Örnekler
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
Arşiv içinde sıkıştırılacak içeriği ayarlar.
public void SetSource(FileInfo fileInfo)
Parametreler
fileInfo
FileInfo
Giriş akışı olarak açılacak FileInfo.
Örnekler
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
İstisnalar
Çağrıcı gerekli izne sahip değil.
Dosya yolu boş veya yalnızca boşluk içeriyor.
Dosya bulunamadı.
Dosya yoluna yalnızca okunabilir veya bir dizin.
fileInfo
null.
Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde bulunuyor.
Dosya zaten açık.
SetSource(string)
Arşiv içinde sıkıştırılacak içeriği ayarlar.
public void SetSource(string sourcePath)
Parametreler
sourcePath
string
Giriş akışı olarak açılacak dosyanın yolu.
Örnekler
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
İstisnalar
sourcePath
null veya boş dize.
Çağrıcı gerekli izne sahip değil.
sourcePath
boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.
sourcePath
dosyasına erişim reddedildi.
Belirtilen sourcePath
, dosya adı veya her ikisi sistem tarafından tanımlanan maksimum uzunluğu aşıyor. Örneğin, Windows tabanlı platformlarda yollar 248 karakterden kısa olmalı ve dosya adları 260 karakterden kısa olmalıdır.
sourcePath
dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.