Class ZArchive

Class ZArchive

A név: Aspose.Zip.Z Összefoglaló: Aspose.Zip.dll (25.5.0)

Ez az osztály egy Z (kompressziós) archív fájlt képvisel. használja a Z archívumok készítéséhez vagy kivonásához.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

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

Lásd https://docs.fileformat.com/compression/z/

Constructors

Archívum()

Kezdeményez egy új példát az Aspose.Zip.Z.Archive osztály felkészült a tömörítésre.

public ZArchive()

Archívum(Áramlat, ZArchiveLoadOptions)

Elindítja az Aspose.Zip.Z.ZArchive osztály új példáját, amely készen áll a dekompresszióra.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

Az archívum forrása.

loadOptions ZArchiveLoadOptions

Az archívum feltöltésének lehetőségei.

Remarks

Ez az építő nem dekompresszi. lásd Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) dekompressziós módszer.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Archívum(Részletesebben ZArchiveLoadOptions)

Elindítja az Aspose.Zip.Z.ZArchive osztály új példáját, amely készen áll a dekompresszióra.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Az út az archívum forrásához.

loadOptions ZArchiveLoadOptions

Az archívum feltöltésének lehetőségei.

Remarks

Ez az építő nem dekompresszi. lásd Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) dekompressziós módszer.

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.

FileNotFoundException

A fájlt nem találták meg.

DirectoryNotFoundException

A kijelölt út nem érvényes, például egy mappátlan vezérlésen.

IOException

A fájl már nyitva van.

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)

Kivonat Z archívum egy áram.

public void Extract(Stream destination)

Parameters

destination Stream

A dekompressziós adatok tárolása.

Examples

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);
        }
    }
}

Exceptions

InvalidDataException

Az adatok nem dekompresszálhatók.

Extract(FileInfo)

Z archívum kivonat egy fájlba.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo a dekompresszált adatok tárolásához.

Examples

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

Exceptions

SecurityException

A hívó nem rendelkezik a fileInfo" megnyitásához szükséges engedélygel.

ArgumentException

A fájlút üres, vagy csak fehér helyeket tartalmaz.

FileNotFoundException

A fájlt nem találták meg.

UnauthorizedAccessException

A fájlhoz vezető út csak olvasható, vagy katalógus.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

A kijelölt út nem érvényes, például egy mappátlan vezérlésen.

IOException

A fájl már nyitva van.

InvalidDataException

Az adatok nem dekompresszálhatók.

Extract(A string)

Kivonat Z archívum egy fájl útján.

public FileInfo Extract(string path)

Parameters

path string

Az út a fájlhoz, amely dekompressziós adatokat tárol.

Returns

FileInfo

Információt egy kivont fájlról.

Examples

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

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 adatok nem dekompresszálhatók.

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 lemez címkéjé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.

Save(Áramlat, ZArchiveSaveOptions)

Megtakarítja a xz archívumot a megadott áramlásra.

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

Parameters

output Stream

A cél áramlása.

settings ZArchiveSaveOptions

Opcionális beállítások archív kompozícióhoz.

Examples

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

Remarks

kereshetőnek kell lennie.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Részletesebben ZArchiveSaveOptions)

A Z archívumot a megadott célfájlhoz mentheti.

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

Parameters

destinationFileName string

+A létrehozandó archívum útja.Ha a megadott fájl neve megjelöli a meglévő fájlt, az átírásra kerül.

settings ZArchiveSaveOptions

Opcionális beállítások archív kompozícióhoz.

Examples

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

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

SetSource(FileInfo)

Állítsa be a tartalmat a nyomtatásra az archívumon belül.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, amely bejárati áramként nyílik meg.

Examples

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

Exceptions

SecurityException

A hívó nem rendelkezik a fileInfo" megnyitásához szükséges engedélygel.

ArgumentException

A fájlút üres, vagy csak fehér helyeket tartalmaz.

FileNotFoundException

A fájlt nem találták meg.

UnauthorizedAccessException

A fájlhoz vezető út csak olvasható, vagy katalógus.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

A kijelölt út nem érvényes, például egy mappátlan vezérlésen.

IOException

A fájl már nyitva van.

SetSource(A string)

Állítsa be a tartalmat a nyomtatásra az archívumon belül.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Az út a fájlhoz, amely bejárati áramként nyílik meg.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

A hívó nem rendelkezik az erőforráshoz való hozzáféréshez szükséges engedélygel.

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

A meghatározott sourcePath’, 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ájlnevek kevesebbnek kell lenniük, mint 260 karakter.

NotSupportedException

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

 Magyar