Class GzipArchive
A név: Aspose.Zip.Gzip Összefoglaló: Aspose.Zip.dll (25.5.0)
Ez az osztály egy gzip archív fájlt képvisel. használja a gzip archívumok készítéséhez vagy kivonásához.
public class GzipArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Örökletes tagok
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
A Gzip tömörítési algoritmus a DEFLATE algoritmuson alapul, amely az LZ77 és a Huffman kódolás kombinációja.
Constructors
GzipArchive()
Kezdeményez egy új példát az Aspose.Zip.Gzip.GzipArchive osztály készen áll a tömörítésre.
public GzipArchive()
Examples
Az alábbi példa azt mutatja, hogyan kell tömöríteni egy fájlt.
using (GzipArchive archive = new GzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.gz");
}
GzipArchive(Áramlás, Bool)
Kezdeményez egy új példát az Aspose.Zip.Gzip.GzipArchive osztály készen áll a dekompresszió.
public GzipArchive(Stream sourceStream, bool parseHeader = false)
Parameters
sourceStream
Stream
Az archívum forrása.
parseHeader
bool
Akár a stream header, hogy megtalálja a tulajdonságokat, beleértve a nevét. Érthető a kereshető stream csak.
Examples
Nyissa meg az archívumot egy áramból, és húzza ki a
var ms = new MemoryStream();
using (GzipArchive archive = new GzipArchive(File.OpenRead("archive.gz")))
archive.Open().CopyTo(ms);
Remarks
Ez az építő nem dekompresszi. lásd Aspose.Zip.Gzip.GzipArchive.Open módszer dekompresszi.
Exceptions
sourceStream’ is null.
sourceStream’ is too short.
A sourceStream’ téves aláírása van.
GzipArchive(Szilveszter, Bool)
Kezdeményez egy új példát az Aspose.Zip.Gzip.GzipArchive osztály.
public GzipArchive(string path, bool parseHeader = false)
Parameters
path
string
Az út az archív fájlhoz.
parseHeader
bool
Akár a stream header, hogy megtalálja a tulajdonságokat, beleértve a nevét. Érthető a kereshető stream csak.
Examples
Nyissa meg az archívumot a fájltól út szerint, és húzza ki a
var ms = new MemoryStream();
using (GzipArchive archive = new GzipArchive("archive.gz"))
archive.Open().CopyTo(ms);
Remarks
Ez az építő nem dekompresszi. lásd Aspose.Zip.Gzip.GzipArchive.Open módszer dekompresszi.
Exceptions
path’ is null.
A hívó nem rendelkezik a szükséges hozzáférési engedélygel.
A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.
A path" fájlhoz való hozzáférés elutasításra kerül.
A meghatározott path", fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.
A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.
A fájl túl rövid.
A fájlban szereplő adatok téves aláírással rendelkeznek.
Properties
Name
Az eredeti fájl neve.
public string Name { get; }
ingatlan értéke
UncompressedSize
Az eredeti fájl méretét kapja.
public ulong UncompressedSize { get; }
ingatlan értéke
Remarks
Ha a nem tömörített fájl mérete meghaladja a 4 GB-ot, ez a tulajdonság hibás értéket ad a 32 bites limit miatt a fejjel.
Methods
Dispose()
Alkalmazás-meghatározott feladatokat végez, amelyek a nem kezelt erőforrások felszabadításával, felszabadításával vagy újrahasznosításával kapcsolatosak.
public void Dispose()
Dispose(Bóli)
Alkalmazás-meghatározott feladatokat végez, amelyek a nem kezelt erőforrások felszabadításával, felszabadításával vagy újrahasznosításával kapcsolatosak.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
A kezelt erőforrások megszüntetésére van szükség.
Extract(Stream)
Kivonja az archívumot a megadott áramlásra.
public void Extract(Stream destination)
Parameters
destination
Stream
Személyes áramlás. meg kell írni.
Examples
using (var archive = new GzipArchive("archive.gz"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Az áramlás korrupt, és nem tartalmaz érvényes adatokat.
Extract(A string)
Az archívumot az útvonalon a fájlba kell kivonni.
public FileInfo Extract(string path)
Parameters
path
string
Az út a célfájlhoz. ha a fájl már létezik, átírásra kerül.
Returns
Információk a kivetett fájlról.
Exceptions
path’ is null.
A hívó nem rendelkezik a szükséges hozzáférési engedélygel.
A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.
A path" fájlhoz való hozzáférés elutasításra kerül.
A meghatározott path", fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.
A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.
Az áramlás korrupt, és nem tartalmaz érvényes adatokat.
ExtractToDirectory(A string)
Kivonja az archívum tartalmát a megadott katalógusba.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Az út a címkéhez, hogy a kivont fájlokat helyezze el.
Remarks
Ha a katalógus nem létezik, akkor létre kell hozni.
Exceptions
destinationDirectory’ is null.
A meghatározott útvonal, a fájl neve vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalaknak kevesebbnek kell lenniük, mint 248 karakter, és a fájlneveknek kevesebbnek kell lenniük, mint 260 karakter.
A hívó nem rendelkezik a meglévő címkéhez való hozzáféréshez szükséges engedéllyel.
Ha a kézikönyv nem létezik, az útvonal tartalmaz egy csomópont karaktert (:) amely nem része a vezérlőjelzőnek (“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 (:).
Az útvonal által meghatározott kézikönyv egy fájl. -or- A hálózati név nem ismert.
Open()
Nyissa meg az archívumot a kivonásra, és áramlást biztosít az archív tartalmakkal.
public Stream Open()
Returns
Az áram, amely az archívum tartalmát képviseli.
Examples
Kivonja az archívumot és másolja a kivont tartalmat a fájl áramlásához.
using (var archive = new GzipArchive("archive.gz"))
{
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);
}
}
A Stream.CopyTo módszert használhatja a .NET 4.0 és annál magasabb verzióhoz: unpacked.KopiTo(kivonat);
Remarks
Olvassa el a folyóiratból, hogy megkapja a fájl eredeti tartalmát. lásd a példák részét.
Save(Stream)
Megtakarítja az archívumot a megadott áramláshoz.
public void Save(Stream outputStream)
Parameters
outputStream
Stream
A cél áramlása.
Examples
Írja a tömörített adatokat a HTTP válaszáramra.
using (var archive = new GzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Remarks
írásszerűnek kell lennie.
Exceptions
outputStream’ is not writable.
A forrás nem áll rendelkezésre.
Save(A string)
Az archívumot a megadott célfájlhoz mentheti.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.
Examples
using (var archive = new GzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.gz");
}
Exceptions
destinationFileName’ is null.
A hívó nem rendelkezik a szükséges hozzáférési engedélygel.
A destinationFileName’ üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.
A destinationFileName" fájlhoz való hozzáférést elutasítják.
A meghatározott destinationFileName’, fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.
A destinationFileName’ fájl tartalmaz egy oszlopot (:) a sor közepén.
SetSource(Stream)
Állítsa be a tartalmat a nyomtatásra az archívumon belül.
public void SetSource(Stream source)
Parameters
source
Stream
A beviteli áram az archívumhoz.
Examples
using (var archive = new GzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.gz");
}
SetSource(FileInfo)
Állítsa be a tartalmat a nyomtatásra az archívumon belül.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
A tömörítendő fájlra való hivatkozás.
Examples
using (var archive = new GzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.gz");
}
SetSource(A string)
Állítsa be a tartalmat a nyomtatásra az archívumon belül.
public void SetSource(string path)
Parameters
path
string
A nyomtatás útja a nyomtatáshoz.
Examples
Nyissa meg az archívumot a fájltól út szerint, és húzza ki a
using (var archive = new GzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.gz");
}
Exceptions
path’ is null.
A hívó nem rendelkezik a szükséges hozzáférési engedélygel.
A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.
A path" fájlhoz való hozzáférés elutasításra kerül.
A meghatározott path", fájlnév, vagy mindkettő meghaladja a rendszer által meghatározott maximális hosszúságot. Például a Windows-alapú platformokon az útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlnévnek kevesebbnek kell lennie, mint 260 karakter.
A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.
SetSource(TarArchive)
Állítsa be a tartalmat a nyomtatásra az archívumon belül.
public void SetSource(TarArchive tarArchive)
Parameters
tarArchive
TarArchive
Az archívumot tömöríteni kell.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var gzippedArchive = new GzipArchive())
{
gzippedArchive.SetSource(tarArchive);
gzippedArchive.Save("archive.tar.gz");
}
}
Remarks
Használja ezt a módszert a közös tar.gz archívum összeállításához.