Class SharArchive

Замовник не має необхідного дозволу на доступ.

UnauthorizedAccessException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

Доступ до файлу path" відмовляється.

DirectoryNotFoundException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path’ містить колону (:) в середині смуги.

FileNotFoundException

Файл не знайдено.

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

Файл вже відкритий.

`Properties`

`Entries`

Отримає записи типу Aspose.Zip.Shar.SharEntry, що складається з архіву.

public ReadOnlyCollection<sharentry> Entries { get; }

`вартість нерухомості`

ReadOnlyCollection • < SharEntry >

`Methods`

`CreateEntries(Стрічка, боол)`

Додайте до архіву всі файли та каталоги знову і знову в даному каталозі.

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(Стриг, Стриг, Боол)`

Створіть єдиний вхід в архіві.

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’ є порожнім, містить тільки білі простори, або містить недійсні символи. - або - Назва файлу, як частина name’, перевищує 100 символів.

Доступ до файлу sourcePath’ відмовляється.

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 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(ІНТ)`

Увімкніть вхід з списку входів за індексу.

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(стрічка)`

Зберегти архіви до даного файлу призначення.

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’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.

Визначена 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.