Class TarArchive
Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)
این کلاس نمایانگر فایل آرشیو tar است. از آن برای ترکیب، استخراج یا بهروزرسانی آرشیوهای tar استفاده کنید.
public class TarArchive : IArchive, IDisposable
وراثت
پیادهسازیها
اعضای ارثبرده
object.GetType()، object.MemberwiseClone()، object.ToString()، object.Equals(object?)، object.Equals(object?, object?)، object.ReferenceEquals(object?, object?)، object.GetHashCode()
سازندهها
TarArchive()
یک نمونه جدید از کلاس Aspose.Zip.Tar.TarArchive را راهاندازی میکند.
public TarArchive()
مثالها
مثال زیر نشان میدهد که چگونه یک فایل را فشرده کنید.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
یک نمونه جدید از کلاس Aspose.Zip.Archive را راهاندازی میکند و لیست ورودیهایی که میتوانند از آرشیو استخراج شوند را ترکیب میکند.
public TarArchive(Stream sourceStream)
پارامترها
sourceStream
Stream
منبع آرشیو. باید قابل جستجو باشد.
مثالها
مثال زیر نشان میدهد که چگونه تمام ورودیها را به یک دایرکتوری استخراج کنید.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
توضیحات
این سازنده هیچ ورودی را unpack نمیکند. برای unpacking به متد Aspose.Zip.Tar.TarEntry.Open مراجعه کنید.
استثناها
sourceStream
قابل جستجو نیست.
TarArchive(string)
یک نمونه جدید از کلاس Aspose.Zip.Tar.TarArchive را راهاندازی میکند و لیست ورودیهایی که میتوانند از آرشیو استخراج شوند را ترکیب میکند.
public TarArchive(string path)
پارامترها
path
string
مسیر فایل آرشیو.
مثالها
مثال زیر نشان میدهد که چگونه تمام ورودیها را به یک دایرکتوری استخراج کنید.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
توضیحات
این سازنده هیچ ورودی را unpack نمیکند. برای unpacking به متد Aspose.Zip.Tar.TarEntry.Open مراجعه کنید.
استثناها
path
null است.
فراخوانیکننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.
دسترسی به فایل path
رد شده است.
path
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فایل در path
شامل یک دو نقطه (:) در وسط رشته است.
فایل پیدا نشد.
مسیر مشخصشده نامعتبر است، مانند اینکه روی یک درایو نامشخص باشد.
فایل قبلاً باز است.
خواص
Entries
ورودیهای نوع Aspose.Zip.Tar.TarEntry را که آرشیو را تشکیل میدهند، بهدست میآورد.
public ReadOnlyCollection<tarentry> Entries { get; }
مقدار خاصیت
ReadOnlyCollection<TarEntry>
متدها
CreateEntries(DirectoryInfo, bool)
تمام فایلها و دایرکتوریها را بهصورت بازگشتی در دایرکتوری دادهشده به آرشیو اضافه میکند.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
پارامترها
directory
DirectoryInfo
دایرکتوری برای فشردهسازی.
includeRootDirectory
bool
نشان میدهد که آیا دایرکتوری ریشه خود را شامل شود یا خیر.
بازگشت
آرشیو با ورودیهای ترکیبشده.
مثالها
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(tarFile);
}
}
CreateEntries(string, bool)
تمام فایلها و دایرکتوریها را بهصورت بازگشتی در دایرکتوری دادهشده به آرشیو اضافه میکند.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
پارامترها
sourceDirectory
string
دایرکتوری برای فشردهسازی.
includeRootDirectory
bool
نشان میدهد که آیا دایرکتوری ریشه خود را شامل شود یا خیر.
بازگشت
آرشیو با ورودیهای ترکیبشده.
مثالها
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(tarFile);
}
}
استثناها
sourceDirectory
null است.
فراخوانیکننده مجوز لازم برای دسترسی به sourceDirectory
را ندارد.
sourceDirectory
شامل کاراکترهای نامعتبر مانند “, <, >، یا | است.
path
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد. path
، نام فایل، یا هر دو خیلی طولانی هستند.
CreateEntry(string, Stream, FileSystemInfo)
یک ورودی واحد را درون آرشیو ایجاد میکند.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
پارامترها
name
string
نام ورودی.
source
Stream
جریان ورودی برای ورودی.
fileInfo
FileSystemInfo
متاداده فایل یا پوشهای که باید فشرده شود.
بازگشت
نمونه ورودی Tar.
مثالها
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
توضیحات
نام ورودی تنها در پارامتر name
تنظیم میشود. نام فایلی که در پارامتر fileInfo
ارائه شده، بر نام ورودی تأثیری ندارد.
fileInfo
میتواند به System.IO.DirectoryInfo اشاره کند اگر ورودی دایرکتوری باشد.
استثناها
name
برای tar به عنوان استاندارد IEEE 1003.1-1998 خیلی طولانی است.
نام فایل، به عنوان بخشی از name
، از 100 نماد بیشتر است.
CreateEntry(string, FileInfo, bool)
یک ورودی واحد را درون آرشیو ایجاد میکند.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
پارامترها
name
string
نام ورودی.
fileInfo
FileInfo
متاداده فایل یا پوشهای که باید فشرده شود.
openImmediately
bool
اگر بلافاصله فایل را باز کند، درست است، در غیر این صورت فایل را در زمان ذخیره آرشیو باز میکند.
بازگشت
نمونه ورودی Tar.
مثالها
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
توضیحات
نام ورودی تنها در پارامتر name
تنظیم میشود. نام فایلی که در پارامتر fileInfo
ارائه شده، بر نام ورودی تأثیری ندارد.
fileInfo
میتواند به System.IO.DirectoryInfo اشاره کند اگر ورودی دایرکتوری باشد.
اگر فایل بلافاصله با پارامتر openImmediately
باز شود، تا زمانی که آرشیو تخلیه شود، مسدود میشود.
استثناها
name
برای tar به عنوان استاندارد IEEE 1003.1-1998 خیلی طولانی است.
نام فایل، به عنوان بخشی از name
، از 100 نماد بیشتر است.
CreateEntry(string, string, bool)
یک ورودی واحد را درون آرشیو ایجاد میکند.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
پارامترها
name
string
نام ورودی.
path
string
مسیر فایل برای فشردهسازی.
openImmediately
bool
اگر بلافاصله فایل را باز کند، درست است، در غیر این صورت فایل را در زمان ذخیره آرشیو باز میکند.
بازگشت
نمونه ورودی Tar.
مثالها
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
توضیحات
نام ورودی تنها در پارامتر name
تنظیم میشود. نام فایلی که در پارامتر path
ارائه شده، بر نام ورودی تأثیری ندارد.
اگر فایل بلافاصله با پارامتر openImmediately
باز شود، تا زمانی که آرشیو تخلیه شود، مسدود میشود.
استثناها
path
null است.
فراخوانیکننده مجوز لازم برای دسترسی را ندارد.
path
خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است. - یا - نام فایل، به عنوان بخشی از name
، از 100 نماد بیشتر است.
دسترسی به فایل path
رد شده است.
path
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد. - یا - name
برای tar به عنوان استاندارد IEEE 1003.1-1998 خیلی طولانی است.
فایل در path
شامل یک دو نقطه (:) در وسط رشته است.
DeleteEntry(TarEntry)
اولین وقوع یک ورودی خاص را از لیست ورودیها حذف میکند.
public TarArchive DeleteEntry(TarEntry entry)
پارامترها
entry
TarEntry
ورودی برای حذف از لیست ورودیها.
بازگشت
آرشیو با ورودی حذفشده.
مثالها
در اینجا نشان میدهد که چگونه میتوانید تمام ورودیها به جز آخرین ورودی را حذف کنید:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(int)
ورودی را از لیست ورودیها بر اساس ایندکس حذف میکند.
public TarArchive DeleteEntry(int entryIndex)
پارامترها
entryIndex
int
ایندکس صفر پایه ورودی برای حذف.
بازگشت
آرشیو با ورودی حذفشده.
مثالها
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
استثناها
entryIndex
کمتر از 0 است. - یا - entryIndex
برابر یا بزرگتر از تعداد Entries
است.
Dispose()
وظایف تعریفشده در برنامه را انجام میدهد که مربوط به آزادسازی، رهاسازی یا بازنشانی منابع غیرمدیریتی است.
public void Dispose()
Dispose(bool)
وظایف تعریفشده در برنامه را انجام میدهد که مربوط به آزادسازی، رهاسازی یا بازنشانی منابع غیرمدیریتی است.
protected virtual void Dispose(bool disposing)
پارامترها
disposing
bool
آیا منابع مدیریتی باید آزاد شوند.
ExtractToDirectory(string)
تمام فایلها را در آرشیو به دایرکتوری ارائهشده استخراج میکند.
public void ExtractToDirectory(string destinationDirectory)
پارامترها
destinationDirectory
string
مسیر دایرکتوری برای قرار دادن فایلهای استخراجشده.
مثالها
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
توضیحات
اگر دایرکتوری وجود نداشته باشد، ایجاد میشود.
استثناها
path null است
path
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
فراخوانیکننده مجوز لازم برای دسترسی به دایرکتوری موجود را ندارد.
اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“C:") است.
path یک رشته با طول صفر است، فقط شامل فضای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. میتوانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید. - یا - path با، یا تنها شامل، یک کاراکتر دو نقطه (:) شروع میشود.
دایرکتوری مشخصشده توسط path یک فایل است. - یا - نام شبکه ناشناخته است.
FromGZip(Stream)
آرشیو gzip ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو gzip بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromGZip(Stream source)
پارامترها
source
Stream
منبع آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
جریان استخراج GZip بهطور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
استثناها
آرشیو خراب است.
FromGZip(string)
آرشیو gzip ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو gzip بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromGZip(string path)
پارامترها
path
string
مسیر فایل آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
جریان استخراج GZip بهطور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
استثناها
آرشیو خراب است.
FromLZMA(Stream)
آرشیو LZMA ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو LZMA بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromLZMA(Stream source)
پارامترها
source
Stream
منبع آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
جریان استخراج LZMA بهطور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromLZMA(string)
آرشیو LZMA ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو LZMA بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromLZMA(string path)
پارامترها
path
string
مسیر فایل آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
جریان استخراج LZMA بهطور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromLZip(Stream)
آرشیو lzip ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو lzip بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromLZip(Stream source)
پارامترها
source
Stream
منبع آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
جریان استخراج lzip بهطور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromLZip(string)
آرشیو lzip ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو lzip بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromLZip(string path)
پارامترها
path
string
مسیر فایل آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
جریان استخراج lzip بهطور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromXz(Stream)
آرشیو xz ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو xz بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromXz(Stream source)
پارامترها
source
Stream
منبع آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromXz(string)
آرشیو xz ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو xz بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromXz(string path)
پارامترها
path
string
مسیر فایل آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromZ(Stream)
آرشیو Z ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو Z بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromZ(Stream source)
پارامترها
source
Stream
منبع آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromZ(string)
آرشیو Z ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو Z بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromZ(string path)
پارامترها
path
string
مسیر فایل آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
توضیحات
آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم میکند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.
FromZstandard(Stream)
آرشیو Zstandard ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو Zstandard بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromZstandard(Stream source)
پارامترها
source
Stream
منبع آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
استثناها
جریان Zstandard خراب یا غیرقابل خواندن است.
داده خراب است.
FromZstandard(string)
آرشیو Zstandard ارائهشده را استخراج میکند و یک Aspose.Zip.Tar.TarArchive از دادههای استخراجشده ترکیب میکند.
مهم: آرشیو Zstandard بهطور کامل در این متد استخراج میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
public static TarArchive FromZstandard(string path)
پارامترها
path
string
مسیر فایل آرشیو.
بازگشت
یک نمونه از Aspose.Zip.Tar.TarArchive
استثناها
جریان Zstandard خراب یا غیرقابل خواندن است.
داده خراب است.
Save(Stream, TarFormat?)
آرشیو را به جریان ارائهشده ذخیره میکند.
public void Save(Stream output, TarFormat? format = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
قابل نوشتن نیست. - یا - output
همان جریانی است که از آن استخراج میکنیم.
- یا -
ذخیره آرشیو در format
به دلیل محدودیتهای فرمت غیرممکن است.
Save(string, TarFormat?)
آرشیو را به فایل مقصد ارائهشده ذخیره میکند.
public void Save(string destinationFileName, TarFormat? format = null)
پارامترها
destinationFileName
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
توضیحات
امکان ذخیره آرشیو در همان مسیری که از آن بارگذاری شده وجود دارد. با این حال، این کار توصیه نمیشود زیرا این روش از کپی به فایل موقت استفاده میکند.
استثناها
destinationFileName
یک رشته با طول صفر است، فقط شامل فضای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است که توسط System.IO.Path.InvalidPathChars تعریف شده است.
destinationFileName
null است.
destinationFileName
، نام فایل، یا هر دو از حداکثر طول تعریفشده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرمهای مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایلها باید کمتر از 260 کاراکتر باشد.
destinationFileName
مشخصشده نامعتبر است، (به عنوان مثال، روی یک درایو نامشخص است).
یک خطای I/O در حین باز کردن فایل رخ داده است.
destinationFileName
فایلی را مشخص کرده است که فقط خواندنی است و دسترسی به آن مجاز نیست. - یا - مسیر مشخصشده یک دایرکتوری است. - یا - فراخوانیکننده مجوز لازم را ندارد.
destinationFileName
در قالب نامعتبر است.
فایل پیدا نشد.
SaveGzipped(Stream, TarFormat?)
آرشیو را به جریان با فشردهسازی gzip ذخیره میکند.
public void SaveGzipped(Stream output, TarFormat? format = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream result = File.OpenWrite("result.tar.gz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped(result);
}
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
null است.
output
قابل نوشتن نیست.
SaveGzipped(string, TarFormat?)
آرشیو را به فایل با مسیر با فشردهسازی gzip ذخیره میکند.
public void SaveGzipped(string path, TarFormat? format = null)
پارامترها
path
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.gz");
}
}
SaveLZMACompressed(Stream, TarFormat?)
آرشیو را به جریان با فشردهسازی LZMA ذخیره میکند.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZMACompressed(result);
}
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
null است.
output
قابل نوشتن نیست.
SaveLZMACompressed(string, TarFormat?)
آرشیو را به فایل با مسیر با فشردهسازی lzma ذخیره میکند.
public void SaveLZMACompressed(string path, TarFormat? format = null)
پارامترها
path
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLZMACompressed("result.tar.lzma");
}
}
توضیحات
مهم: آرشیو tar ابتدا ترکیب شده و سپس فشرده میشود و محتوای آن بهطور داخلی نگهداری میشود. مراقب مصرف حافظه باشید.
SaveLzipped(Stream, TarFormat?)
آرشیو را به جریان با فشردهسازی lzip ذخیره میکند.
public void SaveLzipped(Stream output, TarFormat? format = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream result = File.OpenWrite("result.tar.lz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveLzipped(result);
}
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
null است.
output
قابل نوشتن نیست.
SaveLzipped(string, TarFormat?)
آرشیو را به فایل با مسیر با فشردهسازی lzip ذخیره میکند.
public void SaveLzipped(string path, TarFormat? format = null)
پارامترها
path
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.lz");
}
}
SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)
آرشیو را به جریان با فشردهسازی xz ذخیره میکند.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
settings
XzArchiveSettings
مجموعهای از تنظیمات خاص آرشیو xz: اندازه دیکشنری، اندازه بلوک، نوع چک.
مثالها
using (FileStream result = File.OpenWrite("result.tar.xz"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed(result);
}
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
null است.
output
قابل نوشتن نیست.
SaveXzCompressed(string, TarFormat?, XzArchiveSettings)
آرشیو را به مسیر با فشردهسازی xz ذخیره میکند.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
پارامترها
path
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
settings
XzArchiveSettings
مجموعهای از تنظیمات خاص آرشیو xz: اندازه دیکشنری، اندازه بلوک، نوع چک.
مثالها
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed("result.tar.xz");
}
}
SaveZCompressed(Stream, TarFormat?)
آرشیو را به جریان با فشردهسازی Z ذخیره میکند.
public void SaveZCompressed(Stream output, TarFormat? format = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream result = File.OpenWrite("result.tar.Z"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed(result);
}
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
null است.
output
قابل نوشتن نیست.
SaveZCompressed(string, TarFormat?)
آرشیو را به مسیر با فشردهسازی Z ذخیره میکند.
public void SaveZCompressed(string path, TarFormat? format = null)
پارامترها
path
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed("result.tar.Z");
}
}
SaveZstandard(Stream, TarFormat?)
آرشیو را به جریان با فشردهسازی Zstandard ذخیره میکند.
public void SaveZstandard(Stream output, TarFormat? format = null)
پارامترها
output
Stream
جریان مقصد.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream result = File.OpenWrite("result.tar.zst"))
{
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZstandard(result);
}
}
}
توضیحات
output
باید قابل نوشتن باشد.
استثناها
output
null است.
output
قابل نوشتن نیست.
SaveZstandard(string, TarFormat?)
آرشیو را به فایل با مسیر با فشردهسازی Zstandard ذخیره میکند.
public void SaveZstandard(string path, TarFormat? format = null)
پارامترها
path
string
مسیر آرشیو برای ایجاد. اگر نام فایل مشخصشده به یک فایل موجود اشاره کند، بر روی آن بازنویسی میشود.
format
TarFormat?
فرمت هدر tar را تعریف میکند. مقدار null در صورت امکان به عنوان USTar در نظر گرفته میشود.
مثالها
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZstandard("result.tar.zst");
}
}