Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو سنپی است. از آن برای ترکیب یا استخراج آرشیوهای سنپی استفاده کنید.
public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntryوراثت
پیاده‌سازی‌ها
IArchive, IDisposable, IArchiveFileEntry
اعضای ارث‌برده‌شده
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
سازنده‌ها
SnappyArchive()
یک نمونه جدید از کلاس Aspose.Zip.Snappy.SnappyArchive را برای فشرده‌سازی آماده می‌کند.
public SnappyArchive()مثال‌ها
مثال زیر نشان می‌دهد که چگونه یک فایل را فشرده‌سازی کنید.
using (SnappyArchive archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snapy");
}SnappyArchive(Stream)
یک نمونه جدید از کلاس Aspose.Zip.Snappy.SnappyArchive را برای از فشرده‌سازی آماده می‌کند.
public SnappyArchive(Stream source)پارامترها
source Stream
منبع آرشیو.
یادداشت‌ها
این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) مراجعه کنید.
استثناها
source قابل جستجو نیست.
source تهی است.
SnappyArchive(string)
یک نمونه جدید از کلاس Aspose.Zip.Snappy.SnappyArchive را برای از فشرده‌سازی آماده می‌کند.
public SnappyArchive(string path)پارامترها
path string
مسیر به منبع آرشیو.
مثال‌ها
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new SnappyArchive(sourceSnappyFile))
{
archive.Extract(extractedFile);
}
}یادداشت‌ها
این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) مراجعه کنید.
استثناها
path تهی است.
فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.
path خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path مجاز نیست.
path، نام فایل یا هر دو از طول حداکثر تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.
فایل در path شامل دو نقطه (:) در وسط رشته است.
فایل پیدا نشد.
مسیر مشخص‌شده نامعتبر است، مانند این که در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
متدها
Dispose()
وظایف تعریف‌شده توسط برنامه را در ارتباط با آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.
public void Dispose()Dispose(bool)
وظایف تعریف‌شده توسط برنامه را در ارتباط با آزادسازی، رها کردن یا بازنشانی منابع غیرمدیریتی انجام می‌دهد.
protected virtual void Dispose(bool disposing)پارامترها
disposing bool
آیا منابع مدیریت‌شده باید آزاد شوند.
Extract(Stream)
آرشیو سنپی را به یک جریان استخراج می‌کند.
public void Extract(Stream destination)پارامترها
destination Stream
جریانی برای ذخیره‌سازی داده‌های از فشرده‌سازی خارج‌شده.
مثال‌ها
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);
}
}
}استثناها
سرصفحه‌های آرشیو و اطلاعات سرویس خوانده نشدند.
خطا در داده‌ها در سرصفحه یا checksum.
جریان مقصد تهی است.
جریان مقصد از نوشتن پشتیبانی نمی‌کند.
Extract(FileInfo)
آرشیو سنپی را به یک فایل استخراج می‌کند.
public void Extract(FileInfo fileInfo)پارامترها
fileInfo FileInfo
FileInfo برای ذخیره‌سازی داده‌های از فشرده‌سازی خارج‌شده.
مثال‌ها
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}استثناها
سرصفحه‌های آرشیو و اطلاعات سرویس خوانده نشدند.
فراخوانی‌کننده مجوز لازم برای باز کردن fileInfo را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
fileInfo تهی است.
مسیر مشخص‌شده نامعتبر است، مانند این که در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
Extract(string)
آرشیو سنپی را با مسیر به یک فایل استخراج می‌کند.
public FileInfo Extract(string path)پارامترها
path string
مسیر به فایلی که داده‌های از فشرده‌سازی خارج‌شده را ذخیره خواهد کرد.
بازگشت
نمونه‌ای از System.IO.FileInfo که شامل داده‌های استخراج‌شده است.
مثال‌ها
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract("extracted.bin");
}
}استثناها
سرصفحه‌های آرشیو و اطلاعات سرویس خوانده نشدند.
path تهی است.
فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.
path خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path مجاز نیست.
path، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.
فایل در path شامل دو نقطه (:) در وسط رشته است.
ExtractToDirectory(string)
محتویات آرشیو را به دایرکتوری ارائه‌شده استخراج می‌کند.
public void ExtractToDirectory(string destinationDirectory)پارامترها
destinationDirectory string
مسیر به دایرکتوری که فایل‌های استخراج‌شده در آن قرار خواهند گرفت.
یادداشت‌ها
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
destinationDirectory تهی است.
path، نام فایل یا هر دو از طول حداکثر تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.
فراخوانی‌کننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل کاراکتر دو نقطه (:) باشد که بخشی از برچسب درایو نیست (“C:") باشد.
destinationDirectory یک رشته با طول صفر است، فقط شامل فضاهای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید با استفاده از متد System.IO.Path.GetInvalidPathChars برای کاراکترهای نامعتبر جستجو کنید.
-یا- مسیر با کاراکتر دو نقطه (:) پیشوند شده باشد یا فقط شامل کاراکتر دو نقطه باشد.
دایرکتوری مشخص‌شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته‌شده نیست.
Save(Stream)
آرشیو سنپی را به جریانی که ارائه شده است ذخیره می‌کند.
public void Save(Stream output)پارامترها
output Stream
جریان مقصد.
مثال‌ها
using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save(snappyFile);
}
}یادداشت‌ها
output باید قابل جستجو باشد.
استثناها
output از جستجو پشتیبانی نمی‌کند.
output تهی است.
Save(FileInfo)
آرشیو سنپی را به فایل مقصد که ارائه شده است ذخیره می‌کند.
public void Save(FileInfo destination)پارامترها
destination FileInfo
FileInfo که به عنوان جریان مقصد باز خواهد شد.
مثال‌ها
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.snappy"));
}استثناها
فراخوانی‌کننده مجوز لازم برای باز کردن destination را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
destination تهی است.
مسیر مشخص‌شده نامعتبر است، مانند این که در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
Save(string)
آرشیو سنپی را به فایل مقصد که ارائه شده است ذخیره می‌کند.
public void Save(string destinationFileName)پارامترها
destinationFileName string
مسیر آرشیو که باید ایجاد شود. اگر نام فایل مشخص‌شده به یک فایل موجود اشاره کند، بر روی آن نوشته خواهد شد.
مثال‌ها
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.snappy");
}استثناها
destinationFileName تهی است.
فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.
destinationFileName خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل destinationFileName مجاز نیست.
destinationFileName، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.
فایل در destinationFileName شامل دو نقطه (:) در وسط رشته است.
SetSource(Stream)
محتوا را که باید درون آرشیو فشرده شود، تنظیم می‌کند.
public void SetSource(Stream source)پارامترها
source Stream
جریان ورودی برای آرشیو.
مثال‌ها
using (var archive = new SnappyArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.snappy");
}استثناها
جریان source قابل جستجو نیست.
SetSource(FileInfo)
محتوا را که باید درون آرشیو فشرده شود، تنظیم می‌کند.
public void SetSource(FileInfo fileInfo)پارامترها
fileInfo FileInfo
FileInfo که به عنوان جریان ورودی باز خواهد شد.
مثال‌ها
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.snappy");
}استثناها
فراخوانی‌کننده مجوز لازم برای باز کردن fileInfo را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
fileInfo تهی است.
مسیر مشخص‌شده نامعتبر است، مانند این که در یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
SetSource(string)
محتوا را که باید درون آرشیو فشرده شود، تنظیم می‌کند.
public void SetSource(string sourcePath)پارامترها
sourcePath string
مسیر به فایلی که به عنوان جریان ورودی باز خواهد شد.
مثال‌ها
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snappy");
}استثناها
sourcePath تهی است.
فراخوانی‌کننده مجوز لازم برای دسترسی را ندارد.
sourcePath خالی است، فقط شامل فضاهای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل sourcePath مجاز نیست.
sourcePath، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد.
فایل در sourcePath شامل دو نقطه (:) در وسط رشته است.
