Class ZstandardArchive

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

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

Доступ к файлу 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.

Например, на платформах, основанных на 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 (:).

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.KopyTo(извлечен);

`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" отказывается.