Class GzipArchive

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

object GzipArchive

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

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

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

ArgumentNullException

path’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési engedélygel.

ArgumentException

A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.

UnauthorizedAccessException

A path" fájlhoz való hozzáférés elutasításra kerül.

PathTooLongException

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.

NotSupportedException

A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.

EndOfStreamException

A fájl túl rövid.

InvalidDataException

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

string

UncompressedSize

Az eredeti fájl méretét kapja.

public ulong UncompressedSize { get; }

ingatlan értéke

ulong

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

ArgumentException

destination’ does not support writing.

InvalidDataException

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

FileInfo

Információk a kivetett fájlról.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési engedélygel.

ArgumentException

A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.

UnauthorizedAccessException

A path" fájlhoz való hozzáférés elutasításra kerül.

PathTooLongException

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.

NotSupportedException

A path’ fájl tartalmaz egy oszlopot (:) a sor közepén.

InvalidDataException

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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.

SecurityException

A hívó nem rendelkezik a meglévő címkéhez való hozzáféréshez szükséges engedéllyel.

NotSupportedException

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:”).

ArgumentException

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 (:).

IOException

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

Stream

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

ArgumentException

outputStream’ is not writable.

InvalidOperationException

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési engedélygel.

ArgumentException

A destinationFileName’ üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.

UnauthorizedAccessException

A destinationFileName" fájlhoz való hozzáférést elutasítják.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

path’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési engedélygel.

ArgumentException

A path" üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz.

UnauthorizedAccessException

A path" fájlhoz való hozzáférés elutasításra kerül.

PathTooLongException

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.

NotSupportedException

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.

 Magyar