Class SharArchive

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

UnauthorizedAccessException

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

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

DirectoryNotFoundException

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

NotSupportedException

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

FileNotFoundException

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

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

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

`Properties`

`Entries`

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

public ReadOnlyCollection<sharentry> Entries { get; }

`ارزش املاک`

ReadOnlyCollection &lt؛ SharEntry >

`Methods`

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

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

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

`Parameters`

sourceDirectory string

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

includeRootDirectory bool

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

`Returns`

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

`Examples`

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

`Exceptions`

sourceDirectory’ is null.

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

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

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

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

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

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

`Parameters`

directory DirectoryInfo

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

includeRootDirectory bool

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

`Returns`

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

`Examples`

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

`Exceptions`

directory’ is null.

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

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

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

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

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

`Parameters`

name string

نام ورودی

fileInfo FileInfo

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

openImmediately bool

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

`Returns`

SharEntry

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

`Examples`

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

`Remarks`

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

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string، string، bool)`

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

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

`Parameters`

name string

نام ورودی

sourcePath string

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

openImmediately bool

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

`Returns`

SharEntry

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

`Examples`

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

`Remarks`

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

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

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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

NotSupportedException

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

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

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

public SharEntry CreateEntry(string name, Stream source)

`Parameters`

name string

نام ورودی

source Stream

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

`Returns`

SharEntry

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

`Examples`

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

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

`DeleteEntry(SharEntry)`

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

public SharArchive DeleteEntry(SharEntry entry)

`Parameters`

entry SharEntry

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

`Returns`

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

`Examples`

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

using (var archive = new SharArchive("archive.shar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputSharFile);
}

`Exceptions`

entry’ is null.

`DeleteEntry(int)`

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

public SharArchive DeleteEntry(int entryIndex)

`Parameters`

entryIndex int

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

`Returns`

ArgumentOutOfRangeException

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

`Examples`

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

`Exceptions`

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

`Dispose(بول)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Dispose()`

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

public void Dispose()

`Save(String)`

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

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

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

`Examples`

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

`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 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

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

`Save(Stream)`

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

public void Save(Stream output)

`Parameters`

output Stream

جریان مقصد

`Examples`

using (FileStream sharFile = File.Open("archive.shar", FileMode.Create))
{
    using (var archive = new SharArchive())
    {
        archive.CreateEntry("entry1", "data.bin");        
        archive.Save(sharFile);
    }
}

`Remarks`

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

`Exceptions`

output’ is null.