Class XzArchive

source’ is null.

`XzArchive(Стриг)`

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

public XzArchive(string path)

`Parameters`

path string

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

`Remarks`

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

`Exceptions`

path’ is null.

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

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

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

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

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

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

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

InvalidOperationException

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

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(Боол)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Extract(Stream)`

Экстракт xz архива в поток.

public void Extract(Stream destination)

`Parameters`

destination Stream

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

`Examples`

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

`Exceptions`

Архивные заголовки и информацию о сервисе не читались.

`Extract(FileInfo)`

Экстракт xz архива в файл.

public void Extract(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

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

`Examples`

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

`Exceptions`

InvalidOperationException

Архивные заголовки и информацию о сервисе не читались.

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

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

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

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

fileInfo’ is null.

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

InvalidOperationException

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

`Extract(Стриг)`

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

public FileInfo Extract(string path)

`Parameters`

path string

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

`Returns`

FileInfo

System.IO.FileInfo инстанция, содержащая извлеченные данные.

`Examples`

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

`Exceptions`

Архивные заголовки и информацию о сервисе не читались.

path’ is null.

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

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

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

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

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

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

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

`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(Stream)`

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

public void Save(Stream output)

`Parameters`

output Stream

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

`Examples`

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

`Remarks`

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

`Exceptions`

output’ does not support seeking.

output’ is null.

`Save(Стриг)`

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

public void Save(string destinationFileName)

`Parameters`

destinationFileName string

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

`Examples`

using (var archive = new XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.xz");
}

`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 XzArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.xz");
}

`Exceptions`

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

`SetSource(FileInfo)`

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

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

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

`Examples`

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

`Exceptions`

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

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

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

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

fileInfo’ is null.

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

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

`SetSource(Стриг)`

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

public void SetSource(string sourcePath)

`Parameters`

sourcePath string

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

`Examples`

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

`Exceptions`

sourcePath’ is null.

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

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

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

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