Class TarArchive

Class TarArchive

نام ها : Aspose.Zip.Tar جمع آوری: Aspose.Zip.dll (25.5.0)

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

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

اعضای ارثی

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

TarArchive()

شروع یک مثال جدید از کلاس Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

مثال زیر نشان می دهد که چگونه یک فایل را فشرده کنید.

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

TarArchive(Stream)

یک مثال جدید از کلاس Aspose.Zip.Archive را آغاز می کند و یک لیست ورودی را می سازد که می تواند از آرشیو استخراج شود.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

بایگانی برچسب ها: باید جستجو شود

Examples

مثال زیر نشان می دهد که چگونه تمام ورودی ها را به یک دایرکتوری استخراج کنیم.

using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

این سازنده هیچ ورودی را حذف نمی کند. مشاهده Aspose.Zip.Tar.TarEntry.Open method for unpacking.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(String)

یک مثال جدید از کلاس Aspose.Zip.Tar.tarArchive را آغاز می کند و یک لیست ورودی را می سازد که می تواند از آرشیو استخراج شود.

public TarArchive(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Examples

مثال زیر نشان می دهد که چگونه تمام ورودی ها را به یک دایرکتوری استخراج کنیم.

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

این سازنده هیچ ورودی را حذف نمی کند. مشاهده Aspose.Zip.Tar.TarEntry.Open method for unpacking.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

فایل در حال حاضر باز است.

Properties

Entries

دریافت ورودی از Aspose.Zip.Tar.TarEntry نوع تشکیل آرشیو.

public ReadOnlyCollection<tarentry> Entries { get; }

ارزش املاک

ReadOnlyCollection &lt؛ TarEntry >

Methods

CreateEntries(بایگانی برچسب ها: bool)

اضافه کردن به آرشیو تمام فایل ها و دایرکتوری ها به طور تکراری در دایرکتوری داده شده.

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

Parameters

directory DirectoryInfo

دستورالعمل برای فشرده سازی

includeRootDirectory bool

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

Returns

TarArchive

آرشیو با ورودی های جمع آوری شده

Examples

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(بایگانی برچسب ها: bool)

اضافه کردن به آرشیو تمام فایل ها و دایرکتوری ها به طور تکراری در دایرکتوری داده شده.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Parameters

sourceDirectory string

دستورالعمل برای فشرده سازی

includeRootDirectory bool

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

Returns

TarArchive

آرشیو با ورودی های جمع آوری شده

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

تماس گیرنده اجازه لازم برای دسترسی به sourceDirectory را ندارد.

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

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

CreateEntry(جریان، جریان، FileSystemInfo)

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

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

Parameters

name string

نام ورودی

source Stream

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

fileInfo FileSystemInfo

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

Returns

TarEntry

در ورودی محاکمه

Examples

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

Remarks

نام ورودی فقط در پارامتر تنظیم می شود نام فایل ارائه شده در پارامتر بر نام ورودی تاثیر نمی گذارد.

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

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

CreateEntry(بایگانی برچسب ها: FileInfo, Bool)

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

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

Parameters

name string

نام ورودی

fileInfo FileInfo

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

openImmediately bool

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

Returns

TarEntry

در ورودی محاکمه

Examples

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Remarks

نام ورودی فقط در پارامتر تنظیم می شود نام فایل ارائه شده در پارامتر بر نام ورودی تاثیر نمی گذارد.

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

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

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

CreateEntry(string، string، bool)

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

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

Parameters

name string

نام ورودی

path string

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

openImmediately bool

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

Returns

TarEntry

در ورودی محاکمه

Examples

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

Remarks

نام ورودی فقط در پارامتر تنظیم می شود نام فایل ارائه شده در پارامتر بر نام ورودی تاثیر نمی گذارد.

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

متقاضی مجوز لازم برای دسترسی ندارد.

ArgumentException

کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه کلمه

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" حاوی یک ستون (:) در وسط ردیف است.

DeleteEntry(TarEntry)

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

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

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

Returns

TarArchive

آرشیو با ورودی حذف شد

Examples

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

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)

Parameters

entryIndex int

شاخص مبتنی بر صفر ورودی حذف می شود.

Returns

TarArchive

آرشیو با ورودی حذف شد

Examples

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

Exceptions

ArgumentOutOfRangeException

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

Dispose()

انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.

public void Dispose()

Dispose(بول)

انجام وظایف تعیین شده در برنامه مرتبط با آزاد کردن، آزاد کردن و یا بازگرداندن منابع غیر مدیریت شده.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

آیا منابع مدیریت شده باید از بین برود؟

ExtractToDirectory(String)

تمام فایل ها را در آرشیو به دایرکتوری ارائه شده استخراج کنید.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

Examples

Using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

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

Exceptions

ArgumentNullException

مسیر صفر است

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

مسیر یک ردیف صفر طول است، فقط فضای سفید را شامل می شود، یا حاوی یک یا چند کاراکتر نادرست است.شما می توانید با استفاده از روش System.IO.Path.GetInvalid PathChars برای شخصیت های نامناسب درخواست کنید. - یا - مسیر با یا شامل، تنها یک شخصیت ستون فقرات (:).

IOException

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

از جیپ(Stream)

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

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

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

InvalidDataException

این آرشیو خراب شده است.

از جیپ(String)

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

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

public static TarArchive FromGZip(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

InvalidDataException

این آرشیو خراب شده است.

از LZ4(String)

عصاره های موجود در آرشیو LZ4 و ترکیب Aspose.Zip.Tar.tarArchive از داده های استخراج شده.

مهم: آرشیو LZ4 به طور کامل در این روش استخراج می شود، محتوای آن به صورت داخلی نگهداری شده است.

public static TarArchive FromLZ4(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

کاربر مجوز لازم برای دسترسی ندارد.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

EndOfStreamException

این فایل خیلی کوتاه است.

InvalidDataException

این فایل دارای امضای نادرست است.

از LZ4(Stream)

عصاره های موجود در آرشیو LZ4 و ترکیب Aspose.Zip.Tar.tarArchive از داده های استخراج شده.

مهم: آرشیو LZ4 به طور کامل در این روش استخراج می شود، محتوای آن به صورت داخلی نگهداری شده است.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentException

قابل خواندن از source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

منبع " دارای امضای اشتباه است.

از LZMA(Stream)

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

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

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

InvalidDataException

این آرشیو خراب شده است.

از LZMA(String)

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

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

public static TarArchive FromLZMA(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

از LZIP(Stream)

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

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

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

InvalidDataException

این آرشیو خراب شده است.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

از LZIP(String)

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

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

public static TarArchive FromLZip(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

InvalidDataException

این آرشیو خراب شده است.

FromXz(Stream)

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

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

public static TarArchive FromXz(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

FromXz(String)

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

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

public static TarArchive FromXz(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

از Z(Stream)

عصاره های موجود در آرشیو فرمت Z و ترکیب Aspose.Zip.Tar.TarArchive از داده های استخراج شده.

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

public static TarArchive FromZ(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

از Z(String)

عصاره های موجود در آرشیو فرمت Z و ترکیب Aspose.Zip.Tar.TarArchive از داده های استخراج شده.

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

public static TarArchive FromZ(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Remarks

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

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

FromZstandard(Stream)

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

مهم: آرشیو استاندارد به طور کامل در این روش استخراج می شود، محتوای آن به صورت داخلی نگهداری شده است.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

منبع این آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Exceptions

IOException

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

InvalidDataException

داده ها فساد می کنند.

FromZstandard(String)

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

مهم: آرشیو استاندارد به طور کامل در این روش استخراج می شود، محتوای آن به صورت داخلی نگهداری شده است.

public static TarArchive FromZstandard(string path)

Parameters

path string

راه رفتن به فایل آرشیو

Returns

TarArchive

یک مثال از Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

مسیر path" خالی است، فقط حاوی فضاهای سفید است یا حاوی کاراکترهای نادرست است.

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

فایل در path" در فرمت نادرست است.

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

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

InvalidDataException

داده ها فساد می کنند.

Save(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان ارائه شده.

public void Save(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Remarks

باید نوشته شود.

Exceptions

ArgumentException

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

Save(تریلر، تریلر؟)

ذخیره آرشیو به یک فایل مقصد ارائه شده.

public void Save(string destinationFileName, TarFormat? format = null)

Parameters

destinationFileName string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Remarks

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

Exceptions

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

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

DirectoryNotFoundException

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

IOException

یک خطای I/O در هنگام باز کردن فایل رخ داد.

UnauthorizedAccessException

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

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

SaveGzipped(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان با فشرده سازی gzip

public void SaveGzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Remarks

باید نوشته شود.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(تریلر، تریلر؟)

ذخیره آرشیو به فایل با فشرده سازی gzip.

public void SaveGzipped(string path, TarFormat? format = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

دانلود نرم افزار SaveLZ4Compressed(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان با فشرده سازی LZ4

public void SaveLZ4Compressed(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz4"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZ4Compressed(result);
        }
    }
}

Remarks

باید نوشته شود.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

دانلود نرم افزار SaveLZ4Compressed(تریلر، تریلر؟)

ذخیره آرشیو به فایل در مسیر با LZ4 فشرده سازی.

public void SaveLZ4Compressed(string path, TarFormat? format = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZ4Compressed("result.tar.lz4");
    }
}

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

دانلود نرم افزار Compressed(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان با فشرده سازی LZMA

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Remarks

باید نوشته شود.

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

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

دانلود نرم افزار Compressed(تریلر، تریلر؟)

ذخیره آرشیو به فایل در مسیر با فشرده سازی lzma.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Remarks

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

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان با فشرده سازی lzip.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Remarks

باید نوشته شود.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(تریلر، تریلر؟)

ذخیره آرشیو به فایل در مسیر با فشرده سازی lzip.

public void SaveLzipped(string path, TarFormat? format = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(جریان، TarFormat، XzArchiveSettings)

ذخیره آرشیو به جریان با فشار xz.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

settings XzArchiveSettings

مجموعه تنظیمات خاص xz آرشیو: اندازه دیکشنری، اندازه بلوک، نوع چک.

Examples

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

Remarks

جریان باید قابل نوشتن باشد.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(تگ ها، تگ ها، XzArchiveSettings)

ذخیره آرشیو به مسیر با فشرده سازی xz.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

settings XzArchiveSettings

مجموعه تنظیمات خاص xz آرشیو: اندازه دیکشنری، اندازه بلوک، نوع چک.

Examples

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

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

ذخیره شده(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان با فشرده سازی Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Remarks

باید نوشته شود.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

ذخیره شده(تریلر، تریلر؟)

ذخیره آرشیو به مسیر با فشار Z.

public void SaveZCompressed(string path, TarFormat? format = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(تراکتور یا تراکتور؟)

ذخیره آرشیو به جریان با فشرده سازی استاندارد.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parameters

output Stream

جریان مقصد

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Remarks

باید نوشته شود.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(تریلر، تریلر؟)

ذخیره آرشیو به فایل در مسیر با فشرده سازی استاندارد.

public void SaveZstandard(string path, TarFormat? format = null)

Parameters

path string

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

format TarFormat ?

تعیین فرمت عنوان tar. null value در صورت امکان به عنوان USTar در نظر گرفته خواهد شد.

Examples

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

Exceptions

UnauthorizedAccessException

تماس گیرنده اجازه لازم را ندارد. - یا- path’ مشخص یک فایل یا دایرکتوری خوانده شده است.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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

DirectoryNotFoundException

مشخص شده path’ نادرست است (به عنوان مثال، آن را در یک درایو بدون نقشه برداری است).

NotSupportedException

path’ is in an invalid format.

 فارسی