Class ZstandardArchive

path jest nullem.

Wywołujący nie ma wymaganych uprawnień do dostępu.

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

Dostęp do pliku path jest zabroniony.

Określona path, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na systemie Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

Plik w path zawiera dwukropek (:) w środku ciągu.

Metody

Dispose()

Wykonuje zadania zdefiniowane przez aplikację związane z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów.

public void Dispose()

Dispose(bool)

Wykonuje zadania zdefiniowane przez aplikację związane z uwalnianiem, zwalnianiem lub resetowaniem niezarządzanych zasobów.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

Czy zarządzane zasoby powinny być zwolnione.

Extract(Stream)

Wyodrębnia archiwum do podanego strumienia.

public void Extract(Stream destination)

Parametry

destination Stream

Strumień docelowy. Musi być zapisywalny.

Przykłady

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

Wyjątki

destination nie obsługuje zapisu.

Extract(string)

Wyodrębnia archiwum do pliku według ścieżki.

public FileInfo Extract(string path)

Parametry

path string

Ścieżka do pliku docelowego. Jeśli plik już istnieje, zostanie nadpisany.

Zwraca

FileInfo

Informacje o wyodrębnionym pliku.

Wyjątki

path jest nullem.

Wywołujący nie ma wymaganych uprawnień do dostępu.

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

Dostęp do pliku path jest zabroniony.

Plik w path zawiera dwukropek (:) w środku ciągu.

ExtractToDirectory(string)

Wyodrębnia zawartość archiwum do podanego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Ścieżka do katalogu, w którym mają być umieszczone wyodrębnione pliki.

Uwagi

Jeśli katalog nie istnieje, zostanie utworzony.

Wyjątki

destinationDirectory jest nullem.

Określona ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na systemie Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

Wywołujący nie ma wymaganych uprawnień do dostępu do istniejącego katalogu.

Jeśli katalog nie istnieje, ścieżka zawiera znak dwukropka (:) który nie jest częścią etykiety dysku (“C:").

destinationDirectory jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz zapytać o nieprawidłowe znaki, używając metody System.IO.Path.GetInvalidPathChars. -lub- ścieżka jest prefiksowana lub zawiera tylko znak dwukropka (:).

IOException

Katalog określony przez ścieżkę jest plikiem. -lub- Nazwa sieciowa jest nieznana.

Open()

Otwiera archiwum do ekstrakcji i udostępnia strumień z zawartością archiwum.

public Stream Open()

Zwraca

Stream

Strumień reprezentujący zawartość archiwum.

Przykłady

Wyodrębnia archiwum i kopiuje wyodrębnioną zawartość do strumienia pliku.

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.CopyTo(extracted);`

Uwagi

Odczytaj ze strumienia, aby uzyskać oryginalną zawartość pliku. Zobacz sekcję przykładów.

Save(Stream, ZstandardSaveOptions)

Zapisuje archiwum do podanego strumienia.

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

Parametry

outputStream Stream

Strumień docelowy.

settings ZstandardSaveOptions

Opcjonalne ustawienia do kompozycji archiwum.

Przykłady

Pisze skompresowane dane do strumienia odpowiedzi http.

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

Uwagi

outputStream musi być zapisywalny.

Wyjątki

InvalidOperationException

outputStream nie jest zapisywalny.

Źródło nie zostało dostarczone.

Save(string, ZstandardSaveOptions)

Zapisuje archiwum do podanego pliku docelowego.

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

Parametry

destinationFileName string

Ścieżka archiwum, które ma zostać utworzone. Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

settings ZstandardSaveOptions

Opcjonalne ustawienia do kompozycji archiwum.

Przykłady

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

Wyjątki

destinationFileName jest nullem.

Wywołujący nie ma wymaganych uprawnień do dostępu.

destinationFileName jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

Dostęp do pliku destinationFileName jest zabroniony.

Określona destinationFileName, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system. Na przykład na platformach opartych na systemie Windows, ścieżki muszą mieć mniej niż 248 znaków, a nazwy plików muszą mieć mniej niż 260 znaków.

Plik w destinationFileName zawiera dwukropek (:) w środku ciągu.

Save(FileInfo, ZstandardSaveOptions)

Zapisuje archiwum do podanego pliku docelowego.

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

Parametry

destination FileInfo

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

settings ZstandardSaveOptions

Opcjonalne ustawienia do kompozycji archiwum.

Przykłady

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

Wyjątki

Wywołujący nie ma wymaganych uprawnień do otwarcia destination.

Ścieżka pliku jest pusta lub zawiera tylko białe znaki.

FileNotFoundException

Plik nie został znaleziony.

Ścieżka do pliku jest tylko do odczytu lub jest katalogiem.

DirectoryNotFoundException

destination jest nullem.

Określona ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.

IOException

Plik jest już otwarty.

SetSource(Stream)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(Stream source)

Parametry

source Stream

Strumień wejściowy dla archiwum.

Przykłady

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

SetSource(FileInfo)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(FileInfo fileInfo)

Parametry

fileInfo FileInfo

Referencja do pliku, który ma zostać skompresowany.

Przykłady

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

SetSource(string)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(string path)

Parametry

path string

Ścieżka do pliku, który ma zostać skompresowany.

Przykłady

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

Wyjątki

path jest nullem.

Wywołujący nie ma wymaganych uprawnień do dostępu.

path jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.

Dostęp do pliku path jest zabroniony.