Class CpioArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid cpio archive.

`CpioArchive(String)`

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

public CpioArchive(string path)

`Parameters`

path string

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

`Examples`

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

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

`Remarks`

این سازنده هیچ ورودی را حذف نمی کند. مشاهده Aspose.Zip.Cpio.CpioEntry.Open روش برای حذف بسته بندی.

`Exceptions`

path’ is null.

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

UnauthorizedAccessException

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

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

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

DirectoryNotFoundException

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

FileNotFoundException

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

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

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

`Properties`

`Entries`

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

public ReadOnlyCollection<cpioentry> Entries { get; }

`ارزش املاک`

ReadOnlyCollection &lt؛ CpioEntry >

`Methods`

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

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

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

`Parameters`

sourceDirectory string

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

includeRootDirectory bool

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

`Returns`

Cpio ورودی است.

`Examples`

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

`Exceptions`

sourceDirectory’ is null.

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

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

sourceDirectory’ stands for a file, not for a directory.

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

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

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

`Parameters`

directory DirectoryInfo

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

includeRootDirectory bool

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

`Returns`

Cpio ورودی است.

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(cpioFile);
    }
}

`Exceptions`

directory’ is null.

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

directory’ stands for a file, not for a directory.

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

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

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

`Parameters`

name string

نام ورودی

fileInfo FileInfo

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

openImmediately bool

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

`Returns`

CpioEntry

Cpio ورودی است.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new CpioArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.cpio");
}

`Remarks`

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

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string، string، bool)`

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

public CpioEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)

`Parameters`

name string

نام ورودی

sourcePath string

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

openImmediately bool

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

`Returns`

CpioEntry

Cpio ورودی است.

`Examples`

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

`Remarks`

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

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

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

دسترسی به فایل sourcePath” رد می شود.

برای مثال، در پلتفرم های مبتنی بر ویندوز، مسیرها باید کمتر از 248 کاراکتر باشد و نام فایل ها باید کمتر از 260 کاراکتر باشد. - یا - name’ برای cpio بیش از حد طولانی است.

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

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

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

public CpioEntry CreateEntry(string name, Stream source)

`Parameters`

name string

نام ورودی

source Stream

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

`Returns`

CpioEntry

Cpio ورودی است.

`Examples`

using (var archive = new CpioArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.cpio");
}

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(CpioEntry)`

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

public CpioArchive DeleteEntry(CpioEntry entry)

`Parameters`

entry CpioEntry

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

`Returns`

Cpio ورودی است.

`Examples`

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

using (var archive = new CpioArchive("archive.cpio"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputCpioFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(int)`

ورودی را از لیست ورودی با شاخص حذف کنید.

public CpioArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

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

`Returns`

ArgumentOutOfRangeException

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

`Examples`

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

`Exceptions`

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 CpioArchive("archive.cpio")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

`Remarks`

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

`Exceptions`

مسیر صفر است

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

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

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

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

`Save(برچسب ها: CpioFormat)`

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

public void Save(string destinationFileName, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

destinationFileName string

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

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (var archive = new CpioArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("archive.cpio");
}

`Remarks`

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

`Exceptions`

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

destinationFileName’ is null.

DirectoryNotFoundException

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

UnauthorizedAccessException

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

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

destinationFileName’ is in an invalid format.

`Save(جریان، CpioFormat)`

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

public void Save(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream cpioFile = File.Open("archive.cpio", FileMode.Create))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(cpioFile);
    }
}

`Remarks`

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

`Exceptions`

output’ is null.

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

`SaveGzipped(جریان، CpioFormat)`

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

public void SaveGzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

`Remarks`

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

`Exceptions`

output’ is null.

output’ is not writable.

`SaveGzipped(برچسب ها: CpioFormat)`

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

public void SaveGzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.gz");
    }
}

`دانلود نرم افزار Compressed(جریان، CpioFormat)`

ذخیره فایل به جریان با فشرده سازی LZMA.

public void SaveLZMACompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

`Remarks`

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

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

`دانلود نرم افزار Compressed(برچسب ها: CpioFormat)`

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

public void SaveLZMACompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.cpio.lzma");
    }
}

`Remarks`

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

`SaveLzipped(جریان، CpioFormat)`

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

public void SaveLzipped(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

`Remarks`

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

`Exceptions`

output’ is null.

output’ is not writable.

`SaveLzipped(برچسب ها: CpioFormat)`

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

public void SaveLzipped(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.cpio.lz");
    }
}

`SaveXzCompressed(جریان، CpioFormat، XzArchiveSettings)`

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

public void SaveXzCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

settings XzArchiveSettings

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

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

`Remarks`

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

`Exceptions`

output’ is null.

output’ is not writable.

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

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

public void SaveXzCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii, XzArchiveSettings settings = null)

`Parameters`

path string

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

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

settings XzArchiveSettings

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

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.cpio.xz");
    }
}

`ذخیره شده(جریان، CpioFormat)`

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

public void SaveZCompressed(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

`Remarks`

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

`Exceptions`

output’ is null.

output’ is not writable.

`ذخیره شده(برچسب ها: CpioFormat)`

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

public void SaveZCompressed(string path, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

path string

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

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new CpioArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.cpio.Z");
    }
}

`SaveZstandard(جریان، CpioFormat)`

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

public void SaveZstandard(Stream output, CpioFormat cpioFormat = CpioFormat.OldAscii)

`Parameters`

output Stream

جریان مقصد

cpioFormat CpioFormat

مشخص کردن فرمت cpio header

`Examples`

using (FileStream result = File.OpenWrite("result.cpio.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new CpioArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

`Remarks`

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

`Exceptions`

output’ is null.