Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Térkép, XarLoadOptions)`

Elindítja a Aspose.Zip.Xar.xarArchive osztály új példányát, és összeállítja az archívumból eltávolítható bejegyzéslistát.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Az út az archív fájlhoz.

loadOptions XarLoadOptions

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

`Examples`

Az alábbi példa azt mutatja, hogyan lehet kivonni az összes bejegyzéseket egy címkébe.

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Ez az építő nem törli a bejegyzést. lásd Aspose.Zip.Xar.XarFileEntry.Open módszer a törléshez.

`Exceptions`

path’ is null.

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

UnauthorizedAccessException

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.

DirectoryNotFoundException

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.

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

A fájl már nyitva van.

InvalidDataException

A path" fájl nem érvényes a xar archívumban.

`Properties`

`Entries`

Kap bejegyzéseit Aspose.Zip.Xar.XarEntry típus alkotja az archívumot.

public IEnumerable<xarentry> Entries { get; }

`ingatlan értéke`

IEnumerable < XarEntry >

`Methods`

`CreateEntries(szalag, bool, XarCompressionSettings)`

Hozzáadja az archívumhoz az összes fájlt és címkéket az adott címkében ismétlődően.

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

sourceDirectory string

A kompressziós kézikönyv.

includeRootDirectory bool

Megmutatja, hogy magában foglalja-e a gyökérdirektorát vagy sem.

compressionSettings XarCompressionSettings

A tömörítési beállítások használt hozzáadott Aspose.Zip.Xar.XarEntry elemeket.

`Returns`

XarArchive

Bejelentkezési eljárás.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

`Exceptions`

sourceDirectory’ is null.

A hívó nem rendelkezik a sourceDirectory’hoz való hozzáféréshez szükséges engedélygel.

sourceDirectory’ contains invalid characters such as “, <, >, or |.

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 útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájl neve kevesebbnek kell lennie, mint 260 karakter.

sourceDirectory’ stands for a file, not for a directory.

`CreateEntries(DirectoryInfo, bool, XarCompressionSettings)`

Hozzáadja az archívumhoz az összes fájlt és címkéket az adott címkében ismétlődően.

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

`Parameters`

directory DirectoryInfo

A kompressziós kézikönyv.

includeRootDirectory bool

Megmutatja, hogy magában foglalja-e a gyökérdirektorát vagy sem.

compressionSettings XarCompressionSettings

A tömörítési beállítások használt hozzáadott Aspose.Zip.Xar.XarEntry elemeket.

`Returns`

XarArchive

Bejelentkezési eljárás.

`Examples`

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

`Exceptions`

directory’ is null.

A hívó nem rendelkezik a directory’hoz való hozzáféréshez szükséges engedélygel.

directory’ stands for a file, not for a directory.

`CreateEntry(szalag, FileInfo, bool, XarCompressionSettings)`

Hozzon létre egy egységes bejegyzést az archívumban.

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

A bejárat neve.

fileInfo FileInfo

A fájl vagy a mappa metadata nyomtatásra kerül.

openImmediately bool

Igaz, ha azonnal megnyitja a fájlt, különben megnyitja a fájlt az archív mentés.

compressionSettings XarCompressionSettings

A tömörítési beállításokat az Aspose.Zip.Xar.XarEntry elem hozzáadására használták.

`Returns`

XarEntry

Bejelentkezési eljárás.

`Examples`

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

`Remarks`

Ha a fájl azonnal megnyílik a paraméterrel, akkor az archívum megszűnik.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(szalag, szalag, bool, XarCompressionSettings)`

Hozzon létre egy egységes bejegyzést az archívumban.

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

A bejárat neve.

sourcePath string

A nyomtatás útja a nyomtatáshoz.

openImmediately bool

Igaz, ha azonnal megnyitja a fájlt, különben megnyitja a fájlt az archív mentés.

compressionSettings XarCompressionSettings

A tömörítési beállításokat az Aspose.Zip.Xar.XarEntry elem hozzáadására használták.

`Returns`

XarEntry

Bejelentkezési eljárás.

`Examples`

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

`Remarks`

A paraméterben megadott fájl neve nem befolyásolja a bejegyzés nevét. Ha a fájl azonnal megnyílik a paraméterrel, akkor az archívum megszűnik.

`Exceptions`

sourcePath’ is null.

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

UnauthorizedAccessException

A sourcePath’ üres, csak fehér helyeket tartalmaz, vagy nem érvényes karaktereket tartalmaz. - vagy - A fájl neve, a name’ részeként, meghaladja a 100 szimbólumot.

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

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 útvonalnak kevesebbnek kell lennie, mint 248 karakter, és a fájlneveknek kevesebbnek kell lennie, mint 260 karakter. - vagy - name’ túl hosszú a xar számára.

NotSupportedException

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

Nem lehet megváltoztatni az archívumot.

`CreateEntry(áram, áram, XarCompressionSettings)`

Hozzon létre egy egységes bejegyzést az archívumban.

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

`Parameters`

name string

A bejárat neve.

source Stream

A belépési áram a belépéshez.

compressionSettings XarCompressionSettings

A tömörítési beállításokat az Aspose.Zip.Xar.XarEntry elem hozzáadására használták.

`Returns`

XarEntry

Bejelentkezési eljárás.

`Examples`

using (var archive = new XarArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.xar");
}

`Exceptions`

name’ is null.

source’ is null.

name’ is empty.

Nem lehet megváltoztatni az archívumot.

`DeleteEntry(XarEntry)`

Eltávolítja egy adott bejegyzés első megjelenését a bejegyzéslistából.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

A bejegyzést a bejegyzési listából kell eltávolítani.

`Returns`

XarArchive

Bejelentkezési eljárás.

`Examples`

Íme, hogyan lehet eltávolítani az összes bejegyzés kivéve az utolsó:

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

`Exceptions`

entry’ is null.

`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.

`ExtractToDirectory(A string)`

Az archívumban lévő összes fájlt a megadott katalógusba kell kivonni.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Az út a címkéhez, hogy a kivont fájlokat helyezze el.

`Examples`

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

`Remarks`

Ha a katalógus nem létezik, akkor létre kell hozni.

`Exceptions`

Az út 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.

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

Az útvonal egy nulla hosszúságú vonal, csak fehér helyet tartalmaz, vagy egy vagy több nem érvényes karaktert tartalmaz. Nem érvényes karaktereket kérhet a System.IO.Path.GetInvalidPathChars módszerrel. -or- útvonal előre rögzítve van, vagy csak egy csomó karaktert tartalmaz (:).

Az útvonal által meghatározott kézikönyv egy fájl. -or- A hálózati név nem ismert.

InvalidDataException

Az archívum korrupt.

`Save(Térkép, XarSaveOptions)`

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

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

`Parameters`

destinationFileName string

Ha a megadott fájl neve megjelöli a meglévő fájlt, átírásra kerül.

saveOptions XarSaveOptions

Az archívum megőrzésének lehetőségei.

`Exceptions`

destinationFileName’ is null.

Nem lehet megváltoztatni az archívumot.

`Save(Áramlat, XarSaveOptions)`

Megtakarítja az archívumot a megadott áramláshoz.

public void Save(Stream output, XarSaveOptions saveOptions = null)

`Parameters`

output Stream

A cél áramlása.

saveOptions XarSaveOptions

Az archívum megőrzésének lehetőségei.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.