Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Завантажити XarLoadOptions)`

Ініціалізує нову інстанцію класу Aspose.Zip.Xar.xarАрхів і складає список входів, які можна витягти з архіву.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Шлях до архіву.

loadOptions XarLoadOptions

Вибір варіантів завантаження архіву.

`Examples`

Наступний приклад показує, як витягти всі записи в каталог.

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

`Remarks`

Цей конструктор не депакує жодного входу. переглянути Aspose.Zip.Xar.XarFileEntry.Open метод для депакування.

`Exceptions`

path’ is null.

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

UnauthorizedAccessException

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

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

DirectoryNotFoundException

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

NotSupportedException

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

FileNotFoundException

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

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

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

InvalidDataException

Файл в path’ не є дійсним файлом xar.

`Properties`

`Entries`

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

public IEnumerable<xarentry> Entries { get; }

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

IEnumerable • < XarEntry >

`Methods`

`CreateEntries(Стриг, буль, XarCompressionSettings)`

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

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

Керівництво для компресії.

includeRootDirectory bool

Показати, чи включити сам корінний каталог, чи ні.

compressionSettings XarCompressionSettings

Налаштування компресії використовуються для додавання елементів Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Вхідна інстанція КР.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

Зателефонувач не має необхідного дозволу на доступ до sourceDirectory'.

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

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

`CreateEntries(DirectoryInfo, буль, XarCompressionSettings)`

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

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

Керівництво для компресії.

includeRootDirectory bool

Показати, чи включити сам корінний каталог, чи ні.

compressionSettings XarCompressionSettings

Налаштування компресії використовуються для додавання елементів Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

Вхідна інстанція КР.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

`Exceptions`

directory’ is null.

Зателефонувач не має необхідного дозволу на доступ до directory”.

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

`CreateEntry(Стриг, FileInfo, Bool, XarCompressionSettings)`

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

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Назва входу.

fileInfo FileInfo

Метадани файлу або папки повинні бути компресовані.

openImmediately bool

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

compressionSettings XarCompressionSettings

Налаштування компресії використовуються для додавання елемента Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Вхідна інстанція КР.

`Examples`

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

`Remarks`

Якщо файл відкривається негайно з параметром, він блокується, поки файл не буде видалений.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(струн, струн, буль, XarCompressionSettings)`

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

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Назва входу.

sourcePath string

Шлях до файлу, щоб бути компресованим.

openImmediately bool

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

compressionSettings XarCompressionSettings

Налаштування компресії використовуються для додавання елемента Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Вхідна інстанція КР.

`Examples`

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

`Remarks`

Назва файлу в параметрі не впливає на ім’я входу.

Якщо файл відкривається негайно з параметром, він блокується, поки файл не буде видалений.

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

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

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

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

NotSupportedException

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

Неможливо змінювати архіви.

`CreateEntry(Стрий, Стрий, XarCompressionSettings)`

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

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

Назва входу.

source Stream

Вхідний потік для входу.

compressionSettings XarCompressionSettings

Налаштування компресії використовуються для додавання елемента Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

Вхідна інстанція КР.

`Examples`

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

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

Неможливо змінювати архіви.

`DeleteEntry(XarEntry)`

Видаляється перший випадок конкретного входу з списку входів.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

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

`Returns`

XarArchive

Вхідна інстанція КР.

`Examples`

Ось як ви можете видалити всі записи за винятком останнього:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

`Dispose()`

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

public void Dispose()

`Dispose(Бол)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Чи потрібно витрачати управляні ресурси.

`ExtractToDirectory(стрічка)`

Витягує всі файли в архіві в наданий каталог.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

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

`Examples`

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

`Remarks`

Якщо каталог не існує, він буде створений.

`Exceptions`

Шлях нульовий

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

NotSupportedException

Якщо каталог не існує, то шлях містить символ колону (:) який не є частиною етикетки диска (“C:”).

Шлях - це смуга нульової довжини, містить тільки білий простір, або містить один або кілька недійсних символів. Ви можете запитувати недійсні символи за допомогою методу System.IO.Path.GetInvalidPathChars. -або- Шлях заздалегідь встановлений з, або містить, тільки один символ колону (:).

Директива, зазначена шляхом, є файлом. -або- Назва мережі не відома.

InvalidDataException

Архів був зруйнований.

`Save(Завантажити XarSaveOptions)`

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

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

`Parameters`

destinationFileName string

Якщо назва файлу вказує на існуючий файл, він буде переписаний.

saveOptions XarSaveOptions

Вибір варіантів для збереження файлів xar з.

`Exceptions`

destinationFileName’ is null.

Неможливо змінювати архіви.

`Save(Потік, XarSaveOptions)`

Зберегти архіви до наданого потоку.

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

Потік напряму.

saveOptions XarSaveOptions

Вибір варіантів для збереження файлів xar з.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.