Class ZArchive

source’ is null.

`Архив(Зарядок, ZArchiveLoadOptions)`

Инициализует новую инстанцию класса Aspose.Zip.Z.Archive, подготовленного к декомпрессии.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

`Parameters`

path string

Путь к источнику архива.

loadOptions ZArchiveLoadOptions

С возможностями загрузки архивов.

`Remarks`

Этот конструктор не декомпрессирует. см. Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) метод декомпрессии.

`Exceptions`

path’ is null.

Заказчик не имеет требуемого разрешения на доступ.

path" пустая, содержит только белые пространства или содержит недействительные символы.

Доступ к файлу path" отказывается.

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

DirectoryNotFoundException

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

FileNotFoundException

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

Указанный маршрут является недействительным, например, находиться на немапированном диске.

Файл уже открыт.

`Methods`

`Dispose()`

Осуществляет задания, определенные приложением, связанные с освобождением, освобождением или восстановлением неконтролируемых ресурсов.

public void Dispose()

`Dispose(Боол)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Следует ли использовать управляемые ресурсы.

`Extract(Stream)`

Экстракт Z-архив к потоку.

public void Extract(Stream destination)

`Parameters`

destination Stream

Поток для хранения декомпрессированных данных.

`Examples`

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

`Exceptions`

InvalidDataException

Данные не могут быть декомпрессированы.

`Extract(FileInfo)`

Экстрактирует Z-архив в файл.

public void Extract(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

FileInfo для хранения декомпрессированных данных.

`Examples`

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

`Exceptions`

Вызовчик не имеет требуемого разрешения для открытия fileInfo'.

Путь файла пустая или содержит только белые пространства.

FileNotFoundException

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

Путь к файлу читается только или является каталогом.

DirectoryNotFoundException

fileInfo’ is null.

Указанный маршрут является недействительным, например, находиться на немапированном диске.

Файл уже открыт.

InvalidDataException

Данные не могут быть декомпрессированы.

`Extract(Стриг)`

Экстрактирует Z-архив в файл по пути.

public FileInfo Extract(string path)

`Parameters`

path string

Путь к файлу, который будет хранить декомпрессированные данные.

`Returns`

FileInfo

Информация о извлеченном файле.

`Examples`

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

`Exceptions`

path’ is null.

Заказчик не имеет требуемого разрешения на доступ.

path" пустая, содержит только белые пространства или содержит недействительные символы.

Доступ к файлу path" отказывается.

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

InvalidDataException

Данные не могут быть декомпрессированы.

`ExtractToDirectory(Стриг)`

Экстракт содержимого архива в предоставленный каталог.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Путь к каталогу для размещения извлеченных файлов.

`Remarks`

Если каталог не существует, он будет создан.

`Exceptions`

destinationDirectory’ is null.

Например, на платформах, основанных на Windows, маршруты должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

Заклинатель не имеет требуемого разрешения на доступ к существующему каталогу.

Если каталог не существует, то маршрут содержит колонный характер (:) который не является частью дисковой маркировки («C:»).

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

Каталог, указанный по маршруту, является файлом. -или- Название сети неизвестно.

`Save(Поток, ZArchiveSaveOptions)`

Сохранить xz-архив в предоставленный поток.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

`Parameters`

output Stream

Достопримечательности потока.

settings ZArchiveSaveOptions

Опциональные настройки для архивной композиции.

`Examples`

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

`Remarks`

Она должна быть поисковой.

`Exceptions`

output’ does not support seeking.

output’ is null.

`Save(Зарядок, ZArchiveSaveOptions)`

Сохранить Z-архив в предоставленный целевой файл.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

`Parameters`

destinationFileName string

+Путь архива, который должен быть создан.Если указанное имя файла указывает на существующий файл, он будет переписан.

settings ZArchiveSaveOptions

Опциональные настройки для архивной композиции.

`Examples`

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

`Exceptions`

destinationFileName’ is null.

Заказчик не имеет требуемого разрешения на доступ.

destinationFileName’ является пустым, содержит только белые пространства или содержит недействительные символы.

Доступ к файлу destinationFileName’ отрицается.

Определенный destinationFileName’, имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, маршруты должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

Файл в destinationFileName’ содержит колону (:) в середине строки.

`SetSource(Stream)`

Составьте контент, который должен быть компрессирован в архиве.

public void SetSource(Stream source)

`Parameters`

source Stream

Входный поток для архива.

`Examples`

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

`SetSource(FileInfo)`

Составьте контент, который должен быть компрессирован в архиве.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

FileInfo, который будет открыт как входный поток.

`Examples`

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

`Exceptions`

Вызовчик не имеет требуемого разрешения для открытия fileInfo'.

Путь файла пустая или содержит только белые пространства.

FileNotFoundException

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

Путь к файлу читается только или является каталогом.

DirectoryNotFoundException

fileInfo’ is null.

Указанный маршрут является недействительным, например, находиться на немапированном диске.

Файл уже открыт.

`SetSource(Стриг)`

Составьте контент, который должен быть компрессирован в архиве.

public void SetSource(string sourcePath)

`Parameters`

sourcePath string

Путь к файлу, который будет открыт как входный поток.

`Examples`

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

`Exceptions`

sourcePath’ is null or empty string.

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

sourcePath’ является пустым, содержит только белые пространства, или содержит недействительные символы.

Доступ к файлу sourcePath" отказывается.

Определенный sourcePath", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.