Class ZstandardArchive

Призователят няма изискваното разрешение за достъп.

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

code class=“paramref”>path.

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

code class=“paramref”>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.

Призователят няма изискваното разрешение за достъп.

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

code class=“paramref”>path.

code class=“paramref”>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.

Призователят няма изискваното разрешение за достъп.

code class=“paramref”>destinationFileName.

code class=“paramref”>destinationFileName.

code class=“paramref”>destinationFileName’, име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 символа, а имената на файла трябва да са по-малко от 260.

code class=“paramref”>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`

Призователят не разполага с изискваното разрешение да отвори дестинацията .

Пътят на файла е празен или съдържа само бели пространства.

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.

Призователят няма изискваното разрешение за достъп.

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

code class=“paramref”>path.