Class ZstandardArchive
Namespace: Aspose.Zip.Zstandard
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو Zstandard است. از آن برای تشکیل آرشیوهای Zstandard استفاده کنید.
public class ZstandardArchive : 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()
سازنده‌ها
ZstandardArchive()
یک نمونه جدید از کلاس Aspose.Zip.Zstandard.ZstandardArchive را برای فشرده‌سازی آماده می‌کند.
public ZstandardArchive()مثال‌ها
مثال زیر نشان می‌دهد که چگونه یک فایل را فشرده کنیم.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(Stream, ZstandardLoadOptions)
یک نمونه جدید از کلاس Aspose.Zip.Zstandard.ZstandardArchive را برای استخراج آماده می‌کند.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)پارامترها
sourceStream Stream
منبع آرشیو.
options ZstandardLoadOptions
گزینه‌هایی برای بارگذاری آرشیو.
مثال‌ها
آرشیو را از یک جریان باز کنید و آن را به یک MemoryStream استخراج کنید.
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);یادداشت‌ها
این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Zstandard.ZstandardArchive.Open مراجعه کنید.
ZstandardArchive(string, ZstandardLoadOptions)
یک نمونه جدید از کلاس Aspose.Zip.Zstandard.ZstandardArchive را آماده می‌کند.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)پارامترها
path string
مسیر فایل آرشیو.
options ZstandardLoadOptions
گزینه‌هایی برای بارگذاری آرشیو.
مثال‌ها
آرشیو را از فایل با مسیر باز کنید و آن را به یک MemoryStream استخراج کنید.
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);یادداشت‌ها
این سازنده فشرده‌سازی نمی‌کند. برای فشرده‌سازی به متد Aspose.Zip.Zstandard.ZstandardArchive.Open مراجعه کنید.
استثناها
path برابر null است.
فراخوانی‌کننده اجازه لازم برای دسترسی را ندارد.
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 (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}استثناها
destination از نوشتن پشتیبانی نمی‌کند.
Extract(string)
آرشیو را به فایل با مسیر استخراج می‌کند.
public FileInfo Extract(string path)پارامترها
path string
مسیر به فایل مقصد. اگر فایل از قبل وجود داشته باشد، بازنویسی خواهد شد.
بازگشت
اطلاعات فایل استخراج‌شده.
استثناها
path برابر null است.
فراخوانی‌کننده اجازه لازم برای دسترسی را ندارد.
path خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path ممنوع است.
path مشخص‌شده، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم فراتر می‌روند. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشند.
فایل در path شامل یک دو نقطه (:) در وسط رشته است.
ExtractToDirectory(string)
محتوای آرشیو را به دایرکتوری ارائه‌شده استخراج می‌کند.
public void ExtractToDirectory(string destinationDirectory)پارامترها
destinationDirectory string
مسیر به دایرکتوری که فایل‌های استخراج‌شده در آن قرار خواهند گرفت.
یادداشت‌ها
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
استثناها
destinationDirectory برابر null است.
path مشخص‌شده، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم فراتر می‌روند. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشند.
فراخوانی‌کننده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) باشد که بخشی از برچسب درایو (“C:") نیست.
destinationDirectory یک رشته با طول صفر است، فقط شامل فضاهای خالی است یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید.
-یا- مسیر با یک کاراکتر دو نقطه (:) پیشوند شده است یا فقط شامل کاراکتر دو نقطه است.
دایرکتوری مشخص‌شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته‌شده نیست.
Open()
آرشیو را برای استخراج باز می‌کند و یک جریان با محتوای آرشیو ارائه می‌دهد.
public Stream Open()بازگشت
جریانی که نمایانگر محتوای آرشیو است.
مثال‌ها
آرشیو را استخراج کرده و محتوای استخراج‌شده را به جریان فایل کپی می‌کند.
using (var archive = new ZstandardArchive("archive.zst"))
{
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.CopyTo(extracted);`
یادداشت‌ها
از جریان بخوانید تا محتوای اصلی فایل را دریافت کنید. به بخش مثال‌ها مراجعه کنید.
Save(Stream, ZstandardSaveOptions)
آرشیو را به جریانی که ارائه شده است ذخیره می‌کند.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)پارامترها
outputStream Stream
جریان مقصد.
settings ZstandardSaveOptions
تنظیمات اختیاری برای تشکیل آرشیو.
مثال‌ها
داده‌های فشرده را به جریان پاسخ http می‌نویسد.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}یادداشت‌ها
outputStream باید قابل نوشتن باشد.
استثناها
outputStream قابل نوشتن نیست.
منبع ارائه نشده است.
Save(string, ZstandardSaveOptions)
آرشیو را به فایل مقصد ارائه‌شده ذخیره می‌کند.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)پارامترها
destinationFileName string
مسیر آرشیو که باید ایجاد شود. اگر نام فایل مشخص‌شده به یک فایل موجود اشاره کند، بازنویسی خواهد شد.
settings ZstandardSaveOptions
تنظیمات اختیاری برای تشکیل آرشیو.
مثال‌ها
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}استثناها
destinationFileName برابر null است.
فراخوانی‌کننده اجازه لازم برای دسترسی را ندارد.
destinationFileName خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل destinationFileName ممنوع است.
destinationFileName مشخص‌شده، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم فراتر می‌روند. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشند.
فایل در destinationFileName شامل یک دو نقطه (:) در وسط رشته است.
Save(FileInfo, ZstandardSaveOptions)
آرشیو را به فایل مقصد ارائه‌شده ذخیره می‌کند.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)پارامترها
destination FileInfo
FileInfo که به عنوان جریان مقصد باز خواهد شد.
settings ZstandardSaveOptions
تنظیمات اختیاری برای تشکیل آرشیو.
مثال‌ها
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}استثناها
فراخوانی‌کننده اجازه لازم برای باز کردن destination را ندارد.
مسیر فایل خالی است یا فقط شامل فضاهای خالی است.
فایل پیدا نشد.
مسیر به فایل فقط خواندنی است یا یک دایرکتوری است.
destination برابر null است.
مسیر مشخص‌شده نامعتبر است، مانند اینکه بر روی یک درایو نامشخص باشد.
فایل در حال حاضر باز است.
SetSource(Stream)
محتوا را که باید درون آرشیو فشرده شود، تنظیم می‌کند.
public void SetSource(Stream source)پارامترها
source Stream
جریان ورودی برای آرشیو.
مثال‌ها
using (var archive = new ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
محتوا را که باید درون آرشیو فشرده شود، تنظیم می‌کند.
public void SetSource(FileInfo fileInfo)پارامترها
fileInfo FileInfo
مرجع به فایلی که باید فشرده شود.
مثال‌ها
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(string)
محتوا را که باید درون آرشیو فشرده شود، تنظیم می‌کند.
public void SetSource(string path)پارامترها
path string
مسیر به فایلی که باید فشرده شود.
مثال‌ها
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}استثناها
path برابر null است.
فراخوانی‌کننده اجازه لازم برای دسترسی را ندارد.
path خالی است، فقط شامل فضاهای خالی است یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path ممنوع است.
path مشخص‌شده، نام فایل، یا هر دو از طول حداکثر تعریف‌شده توسط سیستم فراتر می‌روند. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشند.
فایل در path شامل یک دو نقطه (:) در وسط رشته است.
