Class ZstandardArchive

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

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

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

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

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

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(Бол)`

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Extract(Stream)`

Витягніть архіви до наданого потоку.

public void Extract(Stream destination)

`Parameters`

destination Stream

Достовірний маршрут - має бути написані.

`Examples`

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

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

Екстракт архіву до файлу шляхом.

public FileInfo Extract(string path)

`Parameters`

path string

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

`Returns`

FileInfo

Інформація про витягнутий файл.

`Exceptions`

path’ is null.

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

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

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

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

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

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

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

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

`Remarks`

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

`Exceptions`

destinationDirectory’ is null.

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

Якщо каталог не існує, то шлях містить символ колону (:) який не є частиною етикетки диска (“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 (:).

IOException

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

`Open()`

Відкриває архіви для екстракції і забезпечує потік з архівним вмістом.

public Stream Open()

`Returns`

Stream

Потік, що представляє зміст архіву.

`Examples`

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

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Ви можете скористатися методом Stream.CopyTo для .NET 4.0 і вище: unpacked.PopyTo(витягнуто);

`Remarks`

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

`Save(Завантажити, ZstandardSaveOptions)`

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

`Parameters`

outputStream Stream

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

settings ZstandardSaveOptions

Опціональні налаштування для архівної композиції.

`Examples`

Напишіть компресовані дані до потоку відповіді http.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

`Remarks`

Вона повинна бути письмовою.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Джерела не надано.

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

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

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

`Parameters`

destinationFileName string

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

settings ZstandardSaveOptions

Опціональні налаштування для архівної композиції.

`Examples`

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

`Exceptions`

destinationFileName’ is null.

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

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

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

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

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

`Save(Створення FileInfo, ZstandardSaveOptions)`

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

`Parameters`

destination FileInfo

FileInfo, який буде відкритий як напрям призначення.

settings ZstandardSaveOptions

Опціональні налаштування для архівної композиції.

`Examples`

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

`Exceptions`

Зателефонувач не має необхідного дозволу на відкриття destination".

Дорога файлу порожня або містить тільки білі простори.

FileNotFoundException

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

Шлях до файлу читається тільки або є каталогом.

DirectoryNotFoundException

destination’ is null.

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

IOException

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

`SetSource(Stream)`

Налаштуйте контент, який повинен бути компресований в архіві.

public void SetSource(Stream source)

`Parameters`

source Stream

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

`Examples`

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

`SetSource(FileInfo)`

Налаштуйте контент, який повинен бути компресований в архіві.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

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

`Examples`

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

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

Налаштуйте контент, який повинен бути компресований в архіві.

public void SetSource(string path)

`Parameters`

path string

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

`Examples`

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

`Exceptions`

path’ is null.

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

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

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