Class ZArchive

Class ZArchive

Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)

این کلاس نمایانگر فایل آرشیو Z (فشرده‌سازی) است. از آن برای ترکیب یا استخراج آرشیوهای Z استفاده کنید.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

وراثت

objectZArchive

پیاده‌سازی‌ها

IArchive, IDisposable, IArchiveFileEntry

اعضای وراثت یافته

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

شرح

به https://docs.fileformat.com/compression/z/ مراجعه کنید.

سازنده‌ها

ZArchive()

یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای فشرده‌سازی آماده می‌کند.

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای استخراج آماده می‌کند.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

پارامترها

source Stream

منبع آرشیو.

loadOptions ZArchiveLoadOptions

گزینه‌ها برای بارگذاری آرشیو.

توضیحات

این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) مراجعه کنید.

استثناها

ArgumentException

source قابل جستجو نیست.

ArgumentNullException

source تهی است.

ZArchive(string, ZArchiveLoadOptions)

یک نمونه جدید از کلاس Aspose.Zip.Z.ZArchive را برای استخراج آماده می‌کند.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

پارامترها

path string

مسیر به منبع آرشیو.

loadOptions ZArchiveLoadOptions

گزینه‌ها برای بارگذاری آرشیو.

توضیحات

این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) مراجعه کنید.

استثناها

ArgumentNullException

path تهی است.

SecurityException

فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.

ArgumentException

path خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل path رد شده است.

PathTooLongException

path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path شامل یک دو نقطه (:) در وسط رشته است.

FileNotFoundException

فایل یافت نشد.

DirectoryNotFoundException

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نام‌گذاری نشده است.

IOException

فایل قبلاً باز شده است.

متدها

Dispose()

وظایف تعریف‌شده توسط برنامه را برای آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.

public void Dispose()

Dispose(bool)

وظایف تعریف‌شده توسط برنامه را برای آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.

protected virtual void Dispose(bool disposing)

پارامترها

disposing bool

آیا منابع مدیریت‌شده باید آزاد شوند.

Extract(Stream)

آرشیو Z را به یک جریان استخراج می‌کند.

public void Extract(Stream destination)

پارامترها

destination Stream

جریان برای ذخیره‌سازی داده‌های فشرده‌نشده.

مثال‌ها

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);
        }
    }
}

استثناها

InvalidDataException

داده‌ها نمی‌توانند فشرده‌سازی شوند.

Extract(FileInfo)

آرشیو Z را به یک فایل استخراج می‌کند.

public void Extract(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

FileInfo برای ذخیره‌سازی داده‌های فشرده‌نشده.

مثال‌ها

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

استثناها

SecurityException

فراخوانی‌کننده مجوز لازم برای باز کردن fileInfo را ندارد.

ArgumentException

مسیر فایل خالی است یا فقط شامل فضاهای خالی است.

FileNotFoundException

فایل یافت نشد.

UnauthorizedAccessException

مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.

ArgumentNullException

fileInfo تهی است.

DirectoryNotFoundException

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نام‌گذاری نشده است.

IOException

فایل قبلاً باز شده است.

InvalidDataException

داده‌ها نمی‌توانند فشرده‌سازی شوند.

Extract(string)

آرشیو Z را به یک فایل با مسیر استخراج می‌کند.

public FileInfo Extract(string path)

پارامترها

path string

مسیر به فایلی که داده‌های فشرده‌نشده را ذخیره می‌کند.

بازگشت

FileInfo

اطلاعات فایل استخراج‌شده.

مثال‌ها

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

استثناها

ArgumentNullException

path تهی است.

SecurityException

فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.

ArgumentException

path خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل path رد شده است.

PathTooLongException

path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در path شامل یک دو نقطه (:) در وسط رشته است.

InvalidDataException

داده‌ها نمی‌توانند فشرده‌سازی شوند.

ExtractToDirectory(string)

محتویات آرشیو را به دایرکتوری مشخص‌شده استخراج می‌کند.

public void ExtractToDirectory(string destinationDirectory)

پارامترها

destinationDirectory string

مسیر به دایرکتوری برای قرار دادن فایل‌های استخراج‌شده.

توضیحات

اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.

استثناها

ArgumentNullException

destinationDirectory تهی است.

PathTooLongException

destinationDirectory، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

SecurityException

فراخوانی‌کننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.

NotSupportedException

اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“C:") .

ArgumentException

destinationDirectory یک رشته با طول صفر است، فقط شامل فضاهای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید. - یا - مسیر با یک کاراکتر دو نقطه (:) پیشوند یا فقط شامل آن است.

IOException

دایرکتوری مشخص‌شده توسط مسیر یک فایل است. - یا - نام شبکه ناشناخته است.

Save(Stream, ZArchiveSaveOptions)

آرشیو xz را به جریان ارائه‌شده ذخیره می‌کند.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

پارامترها

output Stream

جریان مقصد.

settings ZArchiveSaveOptions

تنظیمات اختیاری برای ترکیب آرشیو.

مثال‌ها

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

توضیحات

output باید قابل جستجو باشد.

استثناها

ArgumentException

output از جستجو پشتیبانی نمی‌کند.

ArgumentNullException

output تهی است.

Save(string, ZArchiveSaveOptions)

آرشیو Z را به فایل مقصد ارائه‌شده ذخیره می‌کند.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

پارامترها

destinationFileName string

+مسیر آرشیو که باید ایجاد شود. اگر نام فایل مشخص‌شده به یک فایل موجود اشاره کند، آن فایل بازنویسی خواهد شد.

settings ZArchiveSaveOptions

تنظیمات اختیاری برای ترکیب آرشیو.

مثال‌ها

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

استثناها

ArgumentNullException

destinationFileName تهی است.

SecurityException

فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.

ArgumentException

destinationFileName خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل destinationFileName رد شده است.

PathTooLongException

destinationFileName، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در destinationFileName شامل یک دو نقطه (:) در وسط رشته است.

SetSource(Stream)

محتویات را برای فشرده‌سازی درون آرشیو تنظیم می‌کند.

public void SetSource(Stream source)

پارامترها

source Stream

جریان ورودی برای آرشیو.

مثال‌ها

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

محتویات را برای فشرده‌سازی درون آرشیو تنظیم می‌کند.

public void SetSource(FileInfo fileInfo)

پارامترها

fileInfo FileInfo

FileInfo که به عنوان جریان ورودی باز خواهد شد.

مثال‌ها

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

استثناها

SecurityException

فراخوانی‌کننده مجوز لازم برای باز کردن fileInfo را ندارد.

ArgumentException

مسیر فایل خالی است یا فقط شامل فضاهای خالی است.

FileNotFoundException

فایل یافت نشد.

UnauthorizedAccessException

مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.

ArgumentNullException

fileInfo تهی است.

DirectoryNotFoundException

مسیر مشخص‌شده نامعتبر است، مانند اینکه در یک درایو نام‌گذاری نشده است.

IOException

فایل قبلاً باز شده است.

SetSource(string)

محتویات را برای فشرده‌سازی درون آرشیو تنظیم می‌کند.

public void SetSource(string sourcePath)

پارامترها

sourcePath string

مسیر به فایلی که به عنوان جریان ورودی باز خواهد شد.

مثال‌ها

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

استثناها

ArgumentNullException

sourcePath تهی است یا رشته خالی است.

SecurityException

فراخوانی‌کننده مجوز لازم برای دسترسی به یک منبع را ندارد.

ArgumentException

sourcePath خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

دسترسی به فایل sourcePath رد شده است.

PathTooLongException

sourcePath، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.

NotSupportedException

فایل در sourcePath شامل یک دو نقطه (:) در وسط رشته است.

 فارسی