Class XzArchive

Class XzArchive

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

Ez az osztály a xz archív fájlt képviseli. használja a xz archívumok összeállításához és kivonásához.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object XzArchive

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

Constructors

XzArchive(XzArchiveSettings)

Elindítja az Aspose.Zip.Xz.XzArchive osztály új példáját, és az archívumot xz formátumban állítja össze.

public XzArchive(XzArchiveSettings settings = null)

Parameters

settings XzArchiveSettings

A beállítások egyedi xz archívum: szótár mérete, blokk mérete, ellenőrzési típus.

XzArchive(Stream)

Kezdeményez egy új példát az Aspose.Zip.Xz.XzArchive osztály felkészült a dekompresszió.

public XzArchive(Stream source)

Parameters

source Stream

Az archívum forrása.

Remarks

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

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

XzArchive(A string)

Kezdeményez egy új példát az Aspose.Zip.Xz.XzArchive osztály felkészült a dekompresszió.

public XzArchive(string path)

Parameters

path string

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

Remarks

Ez az építő nem dekompresszi. lásd Aspose.Zip.Xz.XzArchive.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)

Az xz archívumot egy áramba kell kivonni.

public void Extract(Stream destination)

Parameters

destination Stream

A dekompressziós adatok tárolása.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new XzArchive(xzFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Exceptions

InvalidOperationException

Az archív címek és szolgáltatási információk nem olvashatók.

Extract(FileInfo)

A xz archívumot egy fájlba kell kivonni.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

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

Examples

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

Exceptions

InvalidOperationException

Az archív címek és szolgáltatási információk nem olvashatók.

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.

Extract(A string)

xz archívum kivonása 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

System.IO.FileInfo adatokat tartalmazó beállítás.

Examples

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

Exceptions

InvalidOperationException

Az archív címek és szolgáltatási információk nem olvashatók.

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.

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(Stream)

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

public void Save(Stream output)

Parameters

output Stream

A cél áramlása.

Examples

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

Remarks

kereshetőnek kell lennie.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(A string)

Megtakarítja a xz archívumot a megadott célfájlra.

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 XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.xz");
}

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

Exceptions

ArgumentException

A forrás áramlása nem kereshető.

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 bevezető áramként nyílik meg.

Examples

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

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 XzArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.xz");
}

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

A hívó nem rendelkezik a szükséges hozzáférési 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