Class ZArchive

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

objectZArchive

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

ArgumentException

source erişilebilir değil.

ArgumentNullException

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

ArgumentNullException

path null.

SecurityException

Çağrıcı gerekli izne sahip değil.

ArgumentException

path boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.

UnauthorizedAccessException

path dosyasına erişim reddedildi.

PathTooLongException

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.

NotSupportedException

path dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.

FileNotFoundException

Dosya bulunamadı.

DirectoryNotFoundException

Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde bulunuyor.

IOException

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

InvalidDataException

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

SecurityException

Çağrıcı gerekli izne sahip değil.

ArgumentException

Dosya yolu boş veya yalnızca boşluk içeriyor.

FileNotFoundException

Dosya bulunamadı.

UnauthorizedAccessException

Dosya yolu yalnızca okunabilir veya bir dizin.

ArgumentNullException

fileInfo null.

DirectoryNotFoundException

Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde bulunuyor.

IOException

Dosya zaten açık.

InvalidDataException

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

FileInfo

Çı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

ArgumentNullException

path null.

SecurityException

Çağrıcı gerekli izne sahip değil.

ArgumentException

path boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.

UnauthorizedAccessException

path dosyasına erişim reddedildi.

PathTooLongException

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.

NotSupportedException

path dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.

InvalidDataException

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

ArgumentNullException

destinationDirectory null.

PathTooLongException

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.

SecurityException

Çağrıcı mevcut dizine erişim için gerekli izne sahip değil.

NotSupportedException

Dizin mevcut değilse, yol bir sürücü etiketi (“C:") parçası olmayan bir iki nokta üst üste (:) içeriyor.

ArgumentException

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.

IOException

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

ArgumentException

output erişim desteklemiyor.

ArgumentNullException

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

ArgumentNullException

destinationFileName null.

SecurityException

Çağrıcı gerekli izne sahip değil.

ArgumentException

destinationFileName boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.

UnauthorizedAccessException

destinationFileName dosyasına erişim reddedildi.

PathTooLongException

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.

NotSupportedException

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

SecurityException

Çağrıcı gerekli izne sahip değil.

ArgumentException

Dosya yolu boş veya yalnızca boşluk içeriyor.

FileNotFoundException

Dosya bulunamadı.

UnauthorizedAccessException

Dosya yoluna yalnızca okunabilir veya bir dizin.

ArgumentNullException

fileInfo null.

DirectoryNotFoundException

Belirtilen yol geçersiz, örneğin haritalanmamış bir sürücüde bulunuyor.

IOException

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

ArgumentNullException

sourcePath null veya boş dize.

SecurityException

Çağrıcı gerekli izne sahip değil.

ArgumentException

sourcePath boş, yalnızca boşluk içeriyor veya geçersiz karakterler içeriyor.

UnauthorizedAccessException

sourcePath dosyasına erişim reddedildi.

PathTooLongException

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.

NotSupportedException

sourcePath dosyası, dize içinde bir iki nokta üst üste (:) içeriyor.

 Türkçe