Class ZstandardArchive

Klient nie posiada wymaganego zezwolenia na dostęp.

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

Dostęp do pliku path" jest odrzucony.

Określenie path", nazwa pliku lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach opartych na systemie Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

Plik w path’ zawiera kolumnę (:) w środku paska.

`Methods`

`Dispose()`

Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.

public void Dispose()

`Dispose(Bool)`

Wykonywanie zadań określonych w aplikacji związanych z uwalnianiem, uwalnianiem lub ponownym uwalnianiem nie zarządzanych zasobów.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Czy zarządzane zasoby powinny zostać usunięte?

`Extract(Stream)`

Wyciągnij archiwum do dostarczonego przepływu.

public void Extract(Stream destination)

`Parameters`

destination Stream

Destination stream. musi być pisemny.

`Examples`

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

`Exceptions`

destination’ does not support writing.

`Extract(strumień)`

Wyciągnij archiwum do pliku przez ścieżkę.

public FileInfo Extract(string path)

`Parameters`

path string

Droga do pliku docelowego.Jeśli plik już istnieje, zostanie on przesłany.

`Returns`

FileInfo

Informacje o wydanym pliku.

`Exceptions`

path’ is null.

Klient nie posiada wymaganego zezwolenia na dostęp.

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

Dostęp do pliku path" jest odrzucony.

Plik w path’ zawiera kolumnę (:) w środku paska.

`ExtractToDirectory(strumień)`

Wyciąga treść archiwum do dostarczonego katalogu.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Droga do katalogu, aby umieścić wyciągnięte pliki.

`Remarks`

Jeśli dyrektywa nie istnieje, zostanie ona utworzona.

`Exceptions`

destinationDirectory’ is null.

Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

Odwołujący nie posiada wymaganej pozwolenia na dostęp do istniejącego katalogu.

Jeśli dyrektywa nie istnieje, ścieżka zawiera znak kolumny (:) który nie jest częścią etykiety napędu (“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

Dyskusja określona przez ścieżkę jest plikiem. -or- Nazwa sieci nie jest znana.

`Open()`

Otwiera archiwum do ekstrakcji i zapewnia strumień z treścią archiwum.

public Stream Open()

`Returns`

Stream

Strumień, który reprezentuje treść archiwum.

`Examples`

Wyciąga archiwum i kopiuje wyciągnięte treści do strumienia plików.

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

Możesz użyć metody Stream.CopyTo dla .NET 4.0 i wyższych: unpacked.KopiTo(wyciągnięte);

`Remarks`

Przeczytaj z strumienia, aby uzyskać oryginalną zawartość pliku. zobacz sekcję Przykłady.

`Save(Strumień, ZstandardSaveOptions)`

Oszczędzaj archiwum na dostarczonym strumieniu.

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

`Parameters`

outputStream Stream

Przepływ docelowy.

settings ZstandardSaveOptions

Opcjonalne ustawienia dla kompozycji archiwum.

`Examples`

Wpisz kompresowane dane do strumienia odpowiedzi http.

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

`Remarks`

Musi być pisemny.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Źródła nie zostały dostarczone.

`Save(strumień, ZstandardSaveOptions)`

Zapisz archiwum do dostarczonego pliku docelowego.

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

`Parameters`

destinationFileName string

Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.

settings ZstandardSaveOptions

Opcjonalne ustawienia dla kompozycji archiwum.

`Examples`

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

`Exceptions`

destinationFileName’ is null.

Klient nie posiada wymaganego zezwolenia na dostęp.

destinationFileName’ jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

Dostęp do pliku destinationFileName’ jest odrzucony.

Określenie destinationFileName’, nazwa pliku, lub obie przekracza maksymalną długość określoną przez system. Na przykład, na platformach z systemem Windows, ścieżki muszą być mniejsze niż 248 znaków, a nazwy plików muszą być mniejsze niż 260 znaków.

Plik w adresie destinationFileName’ zawiera kolumnę (:) w środku paska.

`Save(Opcje FileInfo, ZstandardSaveOptions)`

Zapisz archiwum do dostarczonego pliku docelowego.

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

`Parameters`

destination FileInfo

FileInfo, który zostanie otwarty jako strumień docelowy.

settings ZstandardSaveOptions

Opcjonalne ustawienia dla kompozycji archiwum.

`Examples`

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

`Exceptions`

Wzywacz nie ma wymaganej zgody na otwarcie miejsca docelowego .

Droga pliku jest pusta lub zawiera tylko białe przestrzenie.

FileNotFoundException

Plik nie został znaleziony.

Ścieżka do pliku jest czytana tylko lub jest katalogu.

DirectoryNotFoundException

destination’ is null.

Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.

IOException

Archiwum jest już otwarte.

`SetSource(Stream)`

Ustaw zawartość do kompresji w archiwum.

public void SetSource(Stream source)

`Parameters`

source Stream

Przepływ wejściowy do archiwum.

`Examples`

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

`SetSource(FileInfo)`

Ustaw zawartość do kompresji w archiwum.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Odniesienie do pliku do kompresji.

`Examples`

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

`SetSource(strumień)`

Ustaw zawartość do kompresji w archiwum.

public void SetSource(string path)

`Parameters`

path string

Ścieżka do rejestracji do kompresji.

`Examples`

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

`Exceptions`

path’ is null.

Klient nie posiada wymaganego zezwolenia na dostęp.

Ścieżka " jest pusta, zawiera tylko białe przestrzenie lub zawiera nieprawidłowe znaky.

Dostęp do pliku path" jest odrzucony.