Class SnappyArchive

Class SnappyArchive

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

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

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object SnappyArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

اعضای ارثی

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

Constructors

SnappyArchive()

شروع یک مثال جدید از کلاس Aspose.Zip.Snappy.SnappyArchive آماده برای فشرده سازی.

public SnappyArchive()

Examples

مثال زیر نشان می دهد که چگونه یک فایل را فشرده کنید.

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

SnappyArchive(Stream)

شروع یک مثال جدید از کلاس Aspose.Zip.Snappy.SnappyArchive آماده برای انقباض.

public SnappyArchive(Stream source)

Parameters

source Stream

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

Remarks

این سازنده از بین نمی رود. مشاهده Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) روش برای از بین بردن.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

SnappyArchive(String)

شروع یک مثال جدید از کلاس Aspose.Zip.Snappy.SnappyArchive آماده برای انقباض.

public SnappyArchive(string path)

Parameters

path string

راه رسیدن به منبع آرشیو

Examples

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new SnappyArchive(sourceSnappyFile))
    {
         archive.Extract(extractedFile);
    }
   }

Remarks

این سازنده از بین نمی رود. مشاهده Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) روش برای از بین بردن.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

Methods

Dispose()

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

public void Dispose()

Dispose(بول)

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

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

Parameters

destination Stream

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

Examples

using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new SnappyArchive(sourceSnappyFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

Exceptions

InvalidOperationException

عنوان های آرشیو و اطلاعات خدمات خوانده نشده است.

InvalidDataException

اشتباه در داده ها در عنوان یا چک

ArgumentNullException

جریان مقصد صفر است.

ArgumentException

جریان مقصد از نوشتن پشتیبانی نمی کند.

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

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

Examples

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

Exceptions

InvalidOperationException

عنوان های آرشیو و اطلاعات خدمات خوانده نشده است.

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

Extract(String)

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

public FileInfo Extract(string path)

Parameters

path string

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

Returns

FileInfo

سیستم.IO.FileInfo مثال حاوی داده های استخراج شده است.

Examples

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

Exceptions

InvalidOperationException

عنوان های آرشیو و اطلاعات خدمات خوانده نشده است.

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

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

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

Save(Stream)

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

public void Save(Stream output)

Parameters

output Stream

جریان مقصد

Examples

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

Remarks

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

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(FileInfo)

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

public void Save(FileInfo destination)

Parameters

destination FileInfo

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

Examples

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

Exceptions

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

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

IOException

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

Save(String)

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

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

using (var archive = new SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.snappy");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

SetSource(Stream)

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

public void SetSource(Stream source)

Parameters

source Stream

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

Examples

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

Exceptions

ArgumentException

جریان منبع غیر قابل جستجو است.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

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

Examples

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

Exceptions

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

SetSource(String)

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

public void SetSource(string sourcePath)

Parameters

sourcePath string

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

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 فارسی