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
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
source
nie jest możliwe do przeszukiwania.
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
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.
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.
Plik w path
zawiera dwukropek (:) w środku ciągu.
Plik nie został znaleziony.
Podana ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
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
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
Wywołujący nie ma wymaganych uprawnień do otwarcia fileInfo
.
Ścieżka pliku jest pusta lub zawiera tylko białe znaki.
Plik nie został znaleziony.
Ścieżka do pliku jest tylko do odczytu lub jest katalogiem.
fileInfo
jest nullem.
Podana ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
Plik jest już otwarty.
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
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
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.
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.
Plik w path
zawiera dwukropek (:) w środku ciągu.
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
destinationDirectory
jest nullem.
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.
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, korzystając z metody System.IO.Path.GetInvalidPathChars.
-lub- ścieżka jest prefiksowana lub zawiera tylko znak dwukropka (:).
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
output
nie obsługuje przeszukiwania.
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
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.
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.
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
Wywołujący nie ma wymaganych uprawnień do otwarcia fileInfo
.
Ścieżka pliku jest pusta lub zawiera tylko białe znaki.
Plik nie został znaleziony.
Ścieżka do pliku jest tylko do odczytu lub jest katalogiem.
fileInfo
jest nullem.
Podana ścieżka jest nieprawidłowa, na przykład znajduje się na nieprzypisanym dysku.
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
sourcePath
jest nullem lub pustym ciągiem.
Wywołujący nie ma wymaganych uprawnień do dostępu do zasobu.
sourcePath
jest pusty, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki.
Dostęp do pliku sourcePath
jest zabroniony.
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.
Plik w sourcePath
zawiera dwukropek (:) w środku ciągu.