Class ZstandardArchive
نام ها : Aspose.Zip.Zstandard جمع آوری: Aspose.Zip.dll (25.5.0)
این کلاس یک فایل آرشیو استاندارد را نشان می دهد.استفاده از آن برای ترکیب آرشیو استاندارد.
public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
اعضای ارثی
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
ZstandardArchive()
شروع یک مثال جدید از کلاس Aspose.Zip.Zstandard.ZstandardArchive آماده برای فشرده سازی.
public ZstandardArchive()Examples
مثال زیر نشان می دهد که چگونه یک فایل را فشرده کنید.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(جریان، ZstandardLoadOptions)
شروع یک مثال جدید از کلاس Aspose.Zip.Zstandard.ZstandardArchive آماده برای انقباض.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parameters
sourceStream Stream
منبع این آرشیو
options ZstandardLoadOptions
گزینه هایی برای بارگذاری آرشیو
Examples
یک آرشیو را از یک جریان باز کنید و آن را به یک
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Remarks
این سازنده فشرده نمی شود. مشاهده Aspose.Zip.Zstandard.ZstandardArchive.Open روش برای فشرده سازی.
ZstandardArchive(بایگانی برچسب ها: ZstandardLoadOptions)
شروع یک مثال جدید از کلاس Aspose.Zip.Zstandard.ZstandardArchive.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parameters
path string
راه رفتن به فایل آرشیو
options ZstandardLoadOptions
گزینه هایی برای بارگذاری آرشیو
Examples
یک آرشیو را از فایل به مسیر باز کنید و آن را به
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Remarks
این سازنده فشرده نمی شود. مشاهده Aspose.Zip.Zstandard.ZstandardArchive.Open روش برای فشرده سازی.
Exceptions
path’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل path" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در path" حاوی یک ستون (:) در وسط ردیف است.
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 (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(String)
آرشیو را از طریق مسیر به فایل اضافه کنید.
public FileInfo Extract(string path)Parameters
path string
مسیر به مقصد فایل.اگر فایل در حال حاضر وجود دارد، آن را بیش از حد نوشته خواهد شد.
Returns
اطلاعات مربوط به یک فایل استخراج شده
Exceptions
path’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل path" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در path" حاوی یک ستون (:) در وسط ردیف است.
ExtractToDirectory(String)
محتوای آرشیو را به دایرکتوری ارائه شده استخراج کنید.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
مسیر به دایرکتوری برای قرار دادن فایل های استخراج شده در.
Remarks
اگر دایرکتوری وجود نداشته باشد، ایجاد خواهد شد.
Exceptions
destinationDirectory’ is null.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
تماس گیرنده اجازه لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود ندارد، مسیر حاوی یک کاراکتر ستون فقرات (:) است که بخشی از یک برچسب درایو نیست (“C:”).
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 (:).
دایرکتوری مشخص شده توسط مسیر یک فایل است. -یا- نام شبکه شناخته نشده است.
Open()
آرشیو را برای استخراج باز می کند و جریان با محتوای آرشیو را فراهم می کند.
public Stream Open()Returns
جریان که محتوای آرشیو را نشان می دهد.
Examples
آرشیو را استخراج می کند و محتوای استخراج شده را به جریان فایل کپی می کند.
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.Kopy to(extracted).
Remarks
از جریان بخوانید تا محتوای اصلی یک فایل را بدست آورید.
Save(جریان، ZstandardSaveOptions)
ذخیره آرشیو به جریان ارائه شده.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parameters
outputStream Stream
جریان مقصد
settings ZstandardSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو
Examples
داده های فشرده را به جریان پاسخ http بنویسید.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
باید نوشته شود.
Exceptions
outputStream’ is not writable.
منبع ارائه نشده است.
Save(بایگانی برچسب ها: ZstandardSaveOptions)
ذخیره آرشیو به فایل مقصد ارائه شده.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parameters
destinationFileName string
اگر نام فایل مشخص شده به یک فایل موجود اشاره کند، آن را بیش از حد نوشته خواهد شد.
settings ZstandardSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}Exceptions
destinationFileName’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه
دسترسی به فایل destinationFileName’ رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در destinationFileName’ حاوی یک ستون (:) در وسط ردیف است.
Save(بایگانی برچسب ها: ZstandardSaveOptions)
ذخیره آرشیو به فایل مقصد ارائه شده.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parameters
destination FileInfo
FileInfo، که به عنوان جریان مقصد باز خواهد شد.
settings ZstandardSaveOptions
تنظیمات اختیاری برای ترکیب آرشیو
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Exceptions
تماس گیرنده اجازه لازم برای باز کردن destination را ندارد.
مسیر فایل خالی است یا فقط حاوی فضاهای سفید است.
این فایل یافت نشد.
مسیر به فایل فقط خوانده شده است یا یک دایرکتوری است.
destination’ is null.
مسیر مشخص شده نادرست است، به عنوان مثال در یک درایو بدون نقشه.
فایل در حال حاضر باز است.
SetSource(Stream)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(Stream source)Parameters
source Stream
جریان ورودی برای آرشیو
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
ارجاع به یک فایل که باید فشرده شود.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(String)
قرار دادن محتوا برای فشرده سازی در داخل آرشیو
public void SetSource(string path)Parameters
path string
راهی برای فشرده سازی است.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}Exceptions
path’ is null.
متقاضی مجوز لازم برای دسترسی ندارد.
مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.
دسترسی به فایل path" رد می شود.
برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد.
فایل در path" حاوی یک ستون (:) در وسط ردیف است.
