Class ZArchive

Class ZArchive

Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)

Ta klasa reprezentuje plik archiwum Z (kompresja). Użyj jej do tworzenia lub wyodrębniania archiwów Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Dziedziczenie

objectZArchive

Implementuje

IArchive, IDisposable, IArchiveFileEntry

Członkowie dziedziczeni

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Uwagi

Zobacz https://docs.fileformat.com/compression/z/

Konstruktory

ZArchive()

Inicjalizuje nową instancję klasy Aspose.Zip.Z.ZArchive przygotowaną do kompresji.

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

Inicjalizuje nową instancję klasy Aspose.Zip.Z.ZArchive przygotowaną do dekompresji.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parametry

source Stream

Źródło archiwum.

loadOptions ZArchiveLoadOptions

Opcje do załadowania archiwum.

Uwagi

Ten konstruktor nie dekompresuje. Zobacz metodę Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) do dekompresji.

Wyjątki

ArgumentException

source nie jest możliwe do przeszukiwania.

ArgumentNullException

source jest nullem.

ZArchive(string, ZArchiveLoadOptions)

Inicjalizuje nową instancję klasy Aspose.Zip.Z.ZArchive przygotowaną do dekompresji.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parametry

path string

Ścieżka do źródła archiwum.

loadOptions ZArchiveLoadOptions

Opcje do załadowania archiwum.

Uwagi

Ten konstruktor nie dekompresuje. Zobacz metodę Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) do dekompresji.

Wyjątki

ArgumentNullException

path jest nullem.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

Plik nie został znaleziony.

DirectoryNotFoundException

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

IOException

Plik jest już otwarty.

Metody

Dispose()

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

public void Dispose()

Dispose(bool)

Wykonuje zadania zdefiniowane przez aplikację związane z zwalnianiem, uwalnianiem 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 Z do strumienia.

public void Extract(Stream destination)

Parametry

destination Stream

Strumień do przechowywania zdekompresowanych danych.

Przykłady

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Wyjątki

InvalidDataException

Danych nie można zdekompresować.

Extract(FileInfo)

Wyodrębnia archiwum Z do pliku.

public void Extract(FileInfo fileInfo)

Parametry

fileInfo FileInfo

FileInfo do przechowywania zdekompresowanych danych.

Przykłady

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Wyjątki

SecurityException

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

ArgumentException

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

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo jest nullem.

DirectoryNotFoundException

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

IOException

Plik jest już otwarty.

InvalidDataException

Danych nie można zdekompresować.

Extract(string)

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

public FileInfo Extract(string path)

Parametry

path string

Ścieżka do pliku, który będzie przechowywał zdekompresowane dane.

Zwraca

FileInfo

Informacje o wyodrębnionym pliku.

Przykłady

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Wyjątki

ArgumentNullException

path jest nullem.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku path jest zabroniony.

PathTooLongException

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

NotSupportedException

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

InvalidDataException

Danych nie można zdekompresować.

ExtractToDirectory(string)

Wyodrębnia zawartość archiwum do podanego katalogu.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

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

Uwagi

Jeśli katalog nie istnieje, zostanie utworzony.

Wyjątki

ArgumentNullException

destinationDirectory jest nullem.

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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, korzystając z 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 sieci nie jest znana.

Save(Stream, ZArchiveSaveOptions)

Zapisuje archiwum xz do podanego strumienia.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parametry

output Stream

Strumień docelowy.

settings ZArchiveSaveOptions

Opcjonalne ustawienia dla kompozycji archiwum.

Przykłady

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Uwagi

output musi być możliwy do przeszukiwania.

Wyjątki

ArgumentException

output nie obsługuje przeszukiwania.

ArgumentNullException

output jest nullem.

Save(string, ZArchiveSaveOptions)

Zapisuje archiwum Z do podanego pliku docelowego.

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

Parametry

destinationFileName string

+Ścieżka archiwum do utworzenia. Jeśli podana nazwa pliku wskazuje na istniejący plik, zostanie on nadpisany.

settings ZArchiveSaveOptions

Opcjonalne ustawienia dla kompozycji archiwum.

Przykłady

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

Wyjątki

ArgumentNullException

destinationFileName jest nullem.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku destinationFileName jest zabroniony.

PathTooLongException

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

NotSupportedException

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

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 ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(FileInfo fileInfo)

Parametry

fileInfo FileInfo

FileInfo, który zostanie otwarty jako strumień wejściowy.

Przykłady

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

Wyjątki

SecurityException

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

ArgumentException

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

FileNotFoundException

Plik nie został znaleziony.

UnauthorizedAccessException

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

ArgumentNullException

fileInfo jest nullem.

DirectoryNotFoundException

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

IOException

Plik jest już otwarty.

SetSource(string)

Ustawia zawartość do skompresowania w archiwum.

public void SetSource(string sourcePath)

Parametry

sourcePath string

Ścieżka do pliku, który zostanie otwarty jako strumień wejściowy.

Przykłady

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

Wyjątki

ArgumentNullException

sourcePath jest nullem lub pustym ciągiem.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

Dostęp do pliku sourcePath jest zabroniony.

PathTooLongException

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

NotSupportedException

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

 Polski