Class Lz4Archive

Class Lz4Archive

نام ها : Aspose.Zip.Lz4 جمع آوری: Aspose.Zip.dll (25.5.0)

این کلاس فایل آرشیو LZ4 را نشان می دهد.استفاده از آن برای استخراج یا ترکیب فایل های L Z4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

اعضای ارثی

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

Constructors

Lz4Archive(Stream)

شروع یک مثال جدید از کلاس Aspose.Zip.Lz4.Lz4Archive آماده برای تخریب.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

منبع این آرشیو

Examples

یک آرشیو را از یک جریان باز کنید و آن را به یک

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
  archive.Open().CopyTo(ms);

Remarks

این سازنده فشرده نمی شود. مشاهده Aspose.Zip.Lz4.Lz4Archive.Open روش برای فشرده سازی.

Exceptions

ArgumentException

قابل خواندن از sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

sourceStream" دارای امضای اشتباه است.

Lz4Archive(String)

شروع یک مثال جدید از کلاس Aspose.Zip.Lz4.Lz4Archive.

public Lz4Archive(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Examples

یک آرشیو را از فایل به مسیر باز کنید و آن را به

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

Remarks

این سازنده فشرده نمی شود. مشاهده Aspose.Zip.Lz4.Lz4Archive.Open روش برای فشرده سازی.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

کاربر مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

EndOfStreamException

این فایل خیلی کوتاه است.

InvalidDataException

اطلاعات موجود در این فایل دارای امضای نادرست است.

Lz4Archive(Lz4ArchiveSetting)

یک مثال جدید از کلاس Aspose.Zip.Lz4.Lc4Archive آماده برای فشرده سازی آغاز می شود.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

ساختن مجموعه ای از آرشیوها

Methods

Dispose()

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

public void Dispose()

Dispose(بول)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

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

Extract(String)

آرشیو را از طریق مسیر به فایل اضافه کنید.

public FileInfo Extract(string path)

Parameters

path string

مسیر به مقصد فایل.اگر فایل در حال حاضر وجود دارد، آن را بیش از حد نوشته خواهد شد.

Returns

FileInfo

اطلاعات مربوط به یک فایل استخراج شده

Exceptions

EndOfStreamException

جریان منبع بسیار کوتاه است.

InvalidDataException

بایت های نادرست در هنگام رمزگذاری یافت شد.

NotSupportedException

این نسخه LZ4 پشتیبانی نمی شود.

Extract(Stream)

آرشیو را به جریان ارائه شده اضافه کنید.

public void Extract(Stream destination)

Parameters

destination Stream

بایگانی برچسب ها: باید نوشته شود

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

جریان منبع بسیار کوتاه است.

InvalidDataException

بایت های نادرست در هنگام رمزگذاری یافت شد.

NotSupportedException

این نسخه LZ4 پشتیبانی نمی شود.

InvalidOperationException

آرشیو برای ترکیب آماده شده است.

ExtractToDirectory(String)

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

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Remarks

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

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

EndOfStreamException

جریان منبع بسیار کوتاه است.

InvalidDataException

بایت های نادرست پیدا شده در حالی که شروع رمزگذاری.

InvalidOperationException

آرشیو برای ترکیب آماده شده است.

Open()

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

public Stream Open()

Returns

Stream

جریان که محتوای آرشیو را نشان می دهد.

Examples

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

using (var archive = new Lz4Archive("archive.lz4"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

شما می توانید از روش Stream.CopyTo برای .NET 4.0 و بالاتر استفاده کنید: unpacked.Kopy to(extracted).

Remarks

از جریان بخوانید تا محتوای اصلی یک فایل را بدست آورید.

Exceptions

EndOfStreamException

جریان منبع بسیار کوتاه است.

InvalidDataException

بایت های نادرست پیدا شده در حالی که شروع رمزگذاری.

InvalidOperationException

آرشیو برای ترکیب آماده شده است.

Save(Stream)

ذخیره آرشیو lz4 به جریان ارائه شده.

public void Save(Stream output)

Parameters

output Stream

جریان مقصد

Examples

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

Remarks

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

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

آرشیو برای استخراج آماده می شود. - یا - منبع ارائه نشده است.

Save(FileInfo)

ذخیره فایل lz4 به فایل مقصد ارائه شده است.

public void Save(FileInfo destination)

Parameters

destination FileInfo

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

Examples

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

Exceptions

SecurityException

تماس گیرنده اجازه لازم برای باز کردن destination را ندارد.

ArgumentException

مسیر فایل خالی است یا فقط حاوی فضاهای سفید است.

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.

IOException

فایل در حال حاضر باز است.

InvalidOperationException

آرشیو برای استخراج آماده شده است.

Save(String)

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

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

کاربر مجوز لازم برای دسترسی ندارد.

ArgumentException

کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در destinationFileName’ حاوی یک ستون (:) در وسط ردیف است.

InvalidOperationException

آرشیو برای استخراج آماده شده است.

SetSource(Stream)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(Stream source)

Parameters

source Stream

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

Examples

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

Exceptions

InvalidOperationException

آرشیو برای استخراج آماده شده است.

SetSource(FileInfo)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

ارجاع به یک فایل که باید فشرده شود.

Examples

یک آرشیو را از یک جریان باز کنید و آن را به یک

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

Exceptions

InvalidOperationException

آرشیو برای استخراج آماده شده است.

SetSource(بایگانی برچسب ها: TarFormat)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

آرشیو برای فشرده سازی

format TarFormat

مشخص کردن فرمت Tar Header

Examples

using (var tarArchive = new TarArchive())
{
    tarArchive.CreateEntry("first.bin", "data1.bin");
    tarArchive.CreateEntry("second.bin", "data2.bin");
    using (var lz4Archive = new Lz4Archive())
    {
        lz4Archive.SetSource(tarArchive);
        lz4Archive.Save("archive.tar.lz4");
    }
}

Remarks

از این روش برای ترکیب آرشیو مشترک tar.lz4 استفاده کنید.

SetSource(String)

قرار دادن محتوا برای فشرده سازی در داخل آرشیو

public void SetSource(string path)

Parameters

path string

راهی برای فشرده سازی است.

Examples

یک آرشیو را از فایل به مسیر باز کنید و آن را به

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

کاربر مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

InvalidOperationException

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

 فارسی