Class Lz4Archive
Nazwa przestrzeń: Aspose.Zip.Lz4 Zestawienie: Aspose.Zip.dll (25.5.0)
Ta klasa reprezentuje plik archiwum LZ4.Użyj go do ekstrakcji lub kompozycji archivów L Z4.
public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Dziedziczeni członkowie
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
Lz4Archive(Stream)
Inicjalizuje nową instancję klasy Aspose.Zip.Lz4.Lz4Archive przygotowanej do dekompresji.
public Lz4Archive(Stream sourceStream)
Parameters
sourceStream
Stream
Źródło tego archiwum.
Examples
Otwórz archiwum z strumienia i wyciągnij go do
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
archive.Open().CopyTo(ms);
Remarks
Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Lz4.Lz4Archive.Otwarta metoda dekompresji.
Exceptions
Nie można przeczytać z sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
sourceStream’ ma niewłaściwy podpis.
Lz4Archive(strumień)
Inicjalizuje nowy przykład klasy Aspose.Zip.Lz4.Lz4Archive.
public Lz4Archive(string path)
Parameters
path
string
Droga do archiwum.
Examples
Otwórz archiwum z pliku przez ścieżkę i wyciągnij go do
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
archive.Open().CopyTo(ms);
Remarks
Konstruktor ten nie dekompresuje. zobacz Aspose.Zip.Lz4.Lz4Archive.Otwarta metoda dekompresji.
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.
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.
Plik jest zbyt krótki.
Dane zawarte w pliku mają niewłaściwy podpis.
Lz4Archive(Lz4ArchiveSetting)
Inicjalizuje nową instancję klasy Aspose.Zip.Lz4.Lc4Archiwum przygotowane do kompresji.
public Lz4Archive(Lz4ArchiveSetting settings = null)
Parameters
settings
Lz4ArchiveSetting
Ustawienie złożonego archiwum.
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(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
Informacje o wydanym pliku.
Exceptions
Strumień źródłowy jest zbyt krótki.
Niewłaściwe bajty znaleziono podczas dekodowania.
Ta wersja LZ4 nie jest obsługiwana.
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 Lz4Archive("archive.lz4"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Strumień źródłowy jest zbyt krótki.
Niewłaściwe bajty znaleziono podczas dekodowania.
Ta wersja LZ4 nie jest obsługiwana.
Archiwum jest przygotowane do kompozycji.
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 (:).
Dyskusja określona przez ścieżkę jest plikiem. -or- Nazwa sieci nie jest znana.
Strumień źródłowy jest zbyt krótki.
Znaleziono niewłaściwe bajty podczas inicjalizacji dekodowania.
Archiwum jest przygotowane do kompozycji.
Open()
Otwiera archiwum do ekstrakcji i zapewnia strumień z treścią archiwum.
public Stream Open()
Returns
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 Lz4Archive("archive.lz4"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (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.
Exceptions
Strumień źródłowy jest zbyt krótki.
Znaleziono niewłaściwe bajty podczas inicjalizacji dekodowania.
Archiwum jest przygotowane do kompozycji.
Save(Stream)
Oszczędza archiwum lz4 do dostarczonego przepływu.
public void Save(Stream output)
Parameters
output
Stream
Przepływ docelowy.
Examples
using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save(lz4File);
}
}
Remarks
Musi być poszukiwana.
Exceptions
output’ is null.
output’ is not writable.
Archiwum jest przygotowane do ekstrakcji. - lub - Źródło nie zostało dostarczone.
Save(FileInfo)
Oszczędza archiwum lz4 do dostarczonego pliku docelowego.
public void Save(FileInfo destination)
Parameters
destination
FileInfo
FileInfo, który zostanie otwarty jako strumień docelowy.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz4"));
}
Exceptions
Wzywacz nie ma wymaganej zgody na otwarcie miejsca docelowego .
Droga pliku jest pusta lub zawiera tylko białe przestrzenie.
Plik nie został znaleziony.
Ścieżka do pliku jest czytana tylko lub jest katalogu.
destination’ is null.
Określona ścieżka jest nieważna, na przykład na nieokreślonym dysku.
Archiwum jest już otwarte.
Archiwum jest przygotowane do ekstrakcji.
Save(strumień)
Zapisz archiwum do dostarczonego pliku docelowego.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Jeśli określona nazwa pliku wskazuje na istniejący plik, zostanie on przesłany.
Examples
using (var archive = new LZ4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}
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.
Archiwum jest przygotowane do ekstrakcji.
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 Lz4Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz4");
}
Exceptions
Archiwum jest przygotowane do ekstrakcji.
SetSource(FileInfo)
Ustaw zawartość do kompresji w archiwum.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
Odniesienie do pliku do kompresji.
Examples
Otwórz archiwum z strumienia i wyciągnij go do
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz4");
}
Exceptions
Archiwum jest przygotowane do ekstrakcji.
SetSource(Artykuły, TarFormat)
Ustaw zawartość do kompresji w archiwum.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)
Parameters
tarArchive
TarArchive
Archiwum do kompresji.
format
TarFormat
Definicja formatu tar header.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var lz4Archive = new Lz4Archive())
{
lz4Archive.SetSource(tarArchive);
lz4Archive.Save("archive.tar.lz4");
}
}
Remarks
Użyj tej metody do tworzenia wspólnego archiwum tar.lz4.
SetSource(strumień)
Ustaw zawartość do kompresji w archiwum.
public void SetSource(string path)
Parameters
path
string
Ścieżka do rejestracji do kompresji.
Examples
Otwórz archiwum z pliku przez ścieżkę i wyciągnij go do
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}
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.
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.
Archiwum jest przygotowane do ekstrakcji.