Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

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

public class TarArchive : IArchive, IDisposable

وراثت

objectTarArchive

پیاده‌سازی‌ها

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 مراجعه کنید.

استثناها

InvalidDataException

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 مراجعه کنید.

استثناها

ArgumentNullException

path null است.

SecurityException

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

ArgumentException

path خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path شامل یک دو نقطه (:) در وسط رشته است.

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

فایل قبلاً باز است.

خواص

Entries

ورودی‌های نوع Aspose.Zip.Tar.TarEntry را که آرشیو را تشکیل می‌دهند، به‌دست می‌آورد.

public ReadOnlyCollection<tarentry> Entries { get; }

مقدار خاصیت

ReadOnlyCollection<TarEntry&gt;

متدها

CreateEntries(DirectoryInfo, bool)

تمام فایل‌ها و دایرکتوری‌ها را به‌صورت بازگشتی در دایرکتوری داده‌شده به آرشیو اضافه می‌کند.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

پارامترها

directory DirectoryInfo

دایرکتوری برای فشرده‌سازی.

includeRootDirectory bool

نشان می‌دهد که آیا دایرکتوری ریشه خود را شامل شود یا خیر.

بازگشت

TarArchive

آرشیو با ورودی‌های ترکیب‌شده.

مثال‌ها

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

نشان می‌دهد که آیا دایرکتوری ریشه خود را شامل شود یا خیر.

بازگشت

TarArchive

آرشیو با ورودی‌های ترکیب‌شده.

مثال‌ها

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

استثناها

ArgumentNullException

sourceDirectory null است.

SecurityException

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

ArgumentException

sourceDirectory شامل کاراکترهای نامعتبر مانند “, <, >، یا | است.

PathTooLongException

path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد. path، نام فایل، یا هر دو خیلی طولانی هستند.

CreateEntry(string, Stream, FileSystemInfo)

یک ورودی واحد را درون آرشیو ایجاد می‌کند.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

پارامترها

name string

نام ورودی.

source Stream

جریان ورودی برای ورودی.

fileInfo FileSystemInfo

متاداده فایل یا پوشه‌ای که باید فشرده شود.

بازگشت

TarEntry

نمونه ورودی Tar.

مثال‌ها

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

توضیحات

نام ورودی تنها در پارامتر name تنظیم می‌شود. نام فایلی که در پارامتر fileInfo ارائه شده، بر نام ورودی تأثیری ندارد.

fileInfo می‌تواند به System.IO.DirectoryInfo اشاره کند اگر ورودی دایرکتوری باشد.

استثناها

PathTooLongException

name برای tar به عنوان استاندارد IEEE 1003.1-1998 خیلی طولانی است.

ArgumentException

نام فایل، به عنوان بخشی از name، از 100 نماد بیشتر است.

CreateEntry(string, FileInfo, bool)

یک ورودی واحد را درون آرشیو ایجاد می‌کند.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

پارامترها

name string

نام ورودی.

fileInfo FileInfo

متاداده فایل یا پوشه‌ای که باید فشرده شود.

openImmediately bool

اگر بلافاصله فایل را باز کند، درست است، در غیر این صورت فایل را در زمان ذخیره آرشیو باز می‌کند.

بازگشت

TarEntry

نمونه ورودی 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 باز شود، تا زمانی که آرشیو تخلیه شود، مسدود می‌شود.

استثناها

PathTooLongException

name برای tar به عنوان استاندارد IEEE 1003.1-1998 خیلی طولانی است.

ArgumentException

نام فایل، به عنوان بخشی از name، از 100 نماد بیشتر است.

CreateEntry(string, string, bool)

یک ورودی واحد را درون آرشیو ایجاد می‌کند.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

پارامترها

name string

نام ورودی.

path string

مسیر فایل برای فشرده‌سازی.

openImmediately bool

اگر بلافاصله فایل را باز کند، درست است، در غیر این صورت فایل را در زمان ذخیره آرشیو باز می‌کند.

بازگشت

TarEntry

نمونه ورودی Tar.

مثال‌ها

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save(outputTarFile);
}

توضیحات

نام ورودی تنها در پارامتر name تنظیم می‌شود. نام فایلی که در پارامتر path ارائه شده، بر نام ورودی تأثیری ندارد.

اگر فایل بلافاصله با پارامتر openImmediately باز شود، تا زمانی که آرشیو تخلیه شود، مسدود می‌شود.

استثناها

ArgumentNullException

path null است.

SecurityException

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

ArgumentException

path خالی است، فقط شامل فضای خالی است، یا شامل کاراکترهای نامعتبر است. - یا - نام فایل، به عنوان بخشی از name، از 100 نماد بیشتر است.

UnauthorizedAccessException

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

PathTooLongException

path، نام فایل، یا هر دو از حداکثر طول تعریف‌شده توسط سیستم بیشتر است. به عنوان مثال، در پلتفرم‌های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر و نام فایل‌ها باید کمتر از 260 کاراکتر باشد. - یا - name برای tar به عنوان استاندارد IEEE 1003.1-1998 خیلی طولانی است.

NotSupportedException

فایل در path شامل یک دو نقطه (:) در وسط رشته است.

DeleteEntry(TarEntry)

اولین وقوع یک ورودی خاص را از لیست ورودی‌ها حذف می‌کند.

public TarArchive DeleteEntry(TarEntry entry)

پارامترها

entry TarEntry

ورودی برای حذف از لیست ورودی‌ها.

بازگشت

TarArchive

آرشیو با ورودی حذف‌شده.

مثال‌ها

در اینجا نشان می‌دهد که چگونه می‌توانید تمام ورودی‌ها به جز آخرین ورودی را حذف کنید:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

ورودی را از لیست ورودی‌ها بر اساس ایندکس حذف می‌کند.

public TarArchive DeleteEntry(int entryIndex)

پارامترها

entryIndex int

ایندکس صفر پایه ورودی برای حذف.

بازگشت

TarArchive

آرشیو با ورودی حذف‌شده.

مثال‌ها

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

استثناها

ArgumentOutOfRangeException

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");
}

توضیحات

اگر دایرکتوری وجود نداشته باشد، ایجاد می‌شود.

استثناها

ArgumentNullException

path null است

PathTooLongException

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

SecurityException

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

NotSupportedException

اگر دایرکتوری وجود نداشته باشد، مسیر شامل یک کاراکتر دو نقطه (:) است که بخشی از برچسب درایو نیست (“C:") است.

ArgumentException

path یک رشته با طول صفر است، فقط شامل فضای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است. می‌توانید با استفاده از متد System.IO.Path.GetInvalidPathChars کاراکترهای نامعتبر را جستجو کنید. - یا - path با، یا تنها شامل، یک کاراکتر دو نقطه (:) شروع می‌شود.

IOException

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

FromGZip(Stream)

آرشیو gzip ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو gzip به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromGZip(Stream source)

پارامترها

source Stream

منبع آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

جریان استخراج GZip به‌طور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم می‌کند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.

استثناها

InvalidDataException

آرشیو خراب است.

FromGZip(string)

آرشیو gzip ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو gzip به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromGZip(string path)

پارامترها

path string

مسیر فایل آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

جریان استخراج GZip به‌طور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم می‌کند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.

استثناها

InvalidDataException

آرشیو خراب است.

FromLZMA(Stream)

آرشیو LZMA ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو LZMA به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromLZMA(Stream source)

پارامترها

source Stream

منبع آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

جریان استخراج LZMA به‌طور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم می‌کند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.

FromLZMA(string)

آرشیو LZMA ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو LZMA به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromLZMA(string path)

پارامترها

path string

مسیر فایل آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

جریان استخراج LZMA به‌طور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم می‌کند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.

FromLZip(Stream)

آرشیو lzip ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو lzip به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromLZip(Stream source)

پارامترها

source Stream

منبع آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

جریان استخراج lzip به‌طور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم می‌کند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.

FromLZip(string)

آرشیو lzip ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو lzip به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromLZip(string path)

پارامترها

path string

مسیر فایل آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

جریان استخراج lzip به‌طور طبیعی قابل جستجو نیست. آرشیو Tar قابلیت استخراج رکورد دلخواه را فراهم می‌کند، بنابراین باید در زیرساخت خود از جریان قابل جستجو استفاده کند.

FromXz(Stream)

آرشیو xz ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو xz به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromXz(Stream source)

پارامترها

source Stream

منبع آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

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

FromXz(string)

آرشیو xz ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو xz به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromXz(string path)

پارامترها

path string

مسیر فایل آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

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

FromZ(Stream)

آرشیو Z ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو Z به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromZ(Stream source)

پارامترها

source Stream

منبع آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

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

FromZ(string)

آرشیو Z ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو Z به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromZ(string path)

پارامترها

path string

مسیر فایل آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

توضیحات

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

FromZstandard(Stream)

آرشیو Zstandard ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو Zstandard به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromZstandard(Stream source)

پارامترها

source Stream

منبع آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

استثناها

IOException

جریان Zstandard خراب یا غیرقابل خواندن است.

InvalidDataException

داده خراب است.

FromZstandard(string)

آرشیو Zstandard ارائه‌شده را استخراج می‌کند و یک Aspose.Zip.Tar.TarArchive از داده‌های استخراج‌شده ترکیب می‌کند.

مهم: آرشیو Zstandard به‌طور کامل در این متد استخراج می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

public static TarArchive FromZstandard(string path)

پارامترها

path string

مسیر فایل آرشیو.

بازگشت

TarArchive

یک نمونه از Aspose.Zip.Tar.TarArchive

استثناها

IOException

جریان Zstandard خراب یا غیرقابل خواندن است.

InvalidDataException

داده خراب است.

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 باید قابل نوشتن باشد.

استثناها

ArgumentException

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");
}

توضیحات

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

استثناها

ArgumentException

destinationFileName یک رشته با طول صفر است، فقط شامل فضای خالی است، یا شامل یک یا چند کاراکتر نامعتبر است که توسط System.IO.Path.InvalidPathChars تعریف شده است.

ArgumentNullException

destinationFileName null است.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

یک خطای I/O در حین باز کردن فایل رخ داده است.

UnauthorizedAccessException

destinationFileName فایلی را مشخص کرده است که فقط خواندنی است و دسترسی به آن مجاز نیست. - یا - مسیر مشخص‌شده یک دایرکتوری است. - یا - فراخوانی‌کننده مجوز لازم را ندارد.

NotSupportedException

destinationFileName در قالب نامعتبر است.

FileNotFoundException

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

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 باید قابل نوشتن باشد.

استثناها

ArgumentNullException

output null است.

ArgumentException

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 باید قابل نوشتن باشد.

مهم: آرشیو tar ابتدا ترکیب شده و سپس فشرده می‌شود و محتوای آن به‌طور داخلی نگهداری می‌شود. مراقب مصرف حافظه باشید.

استثناها

ArgumentNullException

output null است.

ArgumentException

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 باید قابل نوشتن باشد.

استثناها

ArgumentNullException

output null است.

ArgumentException

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 باید قابل نوشتن باشد.

استثناها

ArgumentNullException

output null است.

ArgumentException

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 باید قابل نوشتن باشد.

استثناها

ArgumentNullException

output null است.

ArgumentException

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 باید قابل نوشتن باشد.

استثناها

ArgumentNullException

output null است.

ArgumentException

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");
    }
}
 فارسی