Class ZstandardArchive

Solicitantul nu are permisiunea necesară de acces.

Calea " este goală, conține doar spații albe sau conține caractere invalide.

Accesul la fișierul path" este refuzat.

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

`Methods`

`Dispose()`

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

public void Dispose()

`Dispose(Boulă)`

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

În cazul în care resursele gestionate ar trebui să fie eliminate.

`Extract(Stream)`

Extrage arhiva în fluxul furnizat.

public void Extract(Stream destination)

`Parameters`

destination Stream

Destination stream. trebuie să fie scris.

`Examples`

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

`Exceptions`

destination’ does not support writing.

`Extract(Strângere)`

Extrageți arhiva în fișier prin traseu.

public FileInfo Extract(string path)

`Parameters`

path string

Calea către fișierul de destinație. dacă fișierul există deja, va fi supraîncris.

`Returns`

FileInfo

Informații despre un fișier extras.

`Exceptions`

path’ is null.

Solicitantul nu are permisiunea necesară de acces.

Calea " este goală, conține doar spații albe sau conține caractere invalide.

Accesul la fișierul path" este refuzat.

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

`ExtractToDirectory(Strângere)`

Extrage conținutul arhivului în directorul furnizat.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Calea către directorie pentru a pune în fișierele extrase.

`Remarks`

Dacă directorul nu există, acesta va fi creat.

`Exceptions`

destinationDirectory’ is null.

Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.

Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă de disc (“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

Directoriul specificat de cale este un fișier. -or- Numele rețelei nu este cunoscut.

`Open()`

Deschide arhiva pentru extracție și oferă un flux cu conținut de arhivă.

public Stream Open()

`Returns`

Stream

Streamul care reprezintă conținutul arhivului.

`Examples`

Extrage fișierul și copiează conținutul extras în fluxul de fișiere.

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);
    }            
}

Puteți folosi metoda Stream.CopyTo pentru .NET 4.0 și mai înalt: unpacked.PopiTo(extract);

`Remarks`

Citiți din flux pentru a obține conținutul original al unui fișier.

`Save(Război, ZstandardSaveOptions)`

Salvează arhiva la fluxul furnizat.

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

`Parameters`

outputStream Stream

Războiul de destinaţie.

settings ZstandardSaveOptions

Setări opționale pentru compoziția arhivelor.

`Examples`

Scrieți datele comprese în fluxul de răspuns HTTP.

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

`Remarks`

Trebuie să fie scrisă.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Sursa nu a fost furnizată.

`Save(Cuvânt cheie, ZstandardSaveOptions)`

Salvează arhiva la fișierul de destinație furnizat.

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

`Parameters`

destinationFileName string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

settings ZstandardSaveOptions

Setări opționale pentru compoziția arhivelor.

`Examples`

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

`Exceptions`

destinationFileName’ is null.

Solicitantul nu are permisiunea necesară de acces.

destinationFileName’ este gol, conține doar spații albe sau conține caractere invalide.

Accesul la fișierul destinationFileName’ este refuzat.

De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

Fișierul la destinationFileName’ conține o coloană (:) în mijlocul stringului.

`Save(FileInfo și ZstandardSaveOptions)`

Salvează arhiva la fișierul de destinație furnizat.

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

`Parameters`

destination FileInfo

FileInfo, care va fi deschis ca flux de destinație.

settings ZstandardSaveOptions

Setări opționale pentru compoziția arhivelor.

`Examples`

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

`Exceptions`

Solicitantul nu are permisiunea necesară pentru a deschide destinația .

Calea fișierului este goală sau conține doar spații albe.

FileNotFoundException

Dosarul nu a fost găsit.

Calea către fișier este doar o lectură sau este un director.

DirectoryNotFoundException

destination’ is null.

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

IOException

Dosarul este deja deschis.

`SetSource(Stream)`

Puneți conținutul pentru a fi comprimat în arhivă.

public void SetSource(Stream source)

`Parameters`

source Stream

Rata de intrare pentru arhivă.

`Examples`

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

`SetSource(FileInfo)`

Puneți conținutul pentru a fi comprimat în arhivă.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Referința la un fișier care trebuie comprimat.

`Examples`

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

`SetSource(Strângere)`

Puneți conținutul pentru a fi comprimat în arhivă.

public void SetSource(string path)

`Parameters`

path string

Calea pentru a fi compresat.

`Examples`

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

`Exceptions`

path’ is null.

Solicitantul nu are permisiunea necesară de acces.

Calea " este goală, conține doar spații albe sau conține caractere invalide.

Accesul la fișierul path" este refuzat.