Class XarArchive

Class XarArchive

Pôvodný názov: Aspose.Zip.Xar Zhromaždenie: Aspose.Zip.dll (25.5.0)

Táto trieda predstavuje archivový súbor xar.

public class XarArchive : IArchive, IDisposable

Inheritance

object XarArchive

Implements

IArchive , IDisposable

Z dedičných členov

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

XarArchive(XarCompressionSettings)

Iniciuje novú inštanciu triedy Aspose.Zip.Xar.XarArchive.

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

Predvolené nastavenia kompresie, ktoré sa vzťahujú na všetky záznamy v archíve.

Examples

Nasledujúci príklad ukazuje, ako komprimovať súbor.

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

XarArchive(Príslušenstvo, XarLoadOptions)

Initalizuje novú inštanciu Aspose.Zip.Xar.xarArchivová trieda a skladá zoznam vstupov, ktoré možno vytiahnuť z archívu.

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

Zdroj archívu, musí byť vyhľadávaný.

loadOptions XarLoadOptions

Možnosti načítania archívov s.

Examples

Nasledujúci príklad ukazuje, ako extrahovať všetky záznamy do katalógu.

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

Remarks

Tento konštruktor neodbalí žiadny vstup. Pozri Aspose.Zip.Xar.XarFileEntry.Otvorte metódu odbalenia.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(Príslušenstvo, XarLoadOptions)

Initalizuje novú inštanciu Aspose.Zip.Xar.xarArchivová trieda a skladá zoznam vstupov, ktoré možno vytiahnuť z archívu.

public XarArchive(string path, XarLoadOptions loadOptions = null)

Parameters

path string

Cesta k archívnemu súboru.

loadOptions XarLoadOptions

Možnosti načítania archívov s.

Examples

Nasledujúci príklad ukazuje, ako extrahovať všetky záznamy do katalógu.

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

Remarks

Tento konštruktor neodbalí žiadny vstup. Pozri Aspose.Zip.Xar.XarFileEntry.Otvorte metódu odbalenia.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.

UnauthorizedAccessException

Prístup k súboru path" je zamietnutý.

PathTooLongException

Názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad, na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

NotSupportedException

Súbor na path’ obsahuje stĺpec (:) v strede riadku.

FileNotFoundException

Súbor sa nenašiel.

DirectoryNotFoundException

Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.

IOException

Súbor je už otvorený.

InvalidDataException

Súbor na path’ nie je platný archív xar.

Properties

Entries

Získava záznamy typu Aspose.Zip.Xar.XarEntry, ktorý tvorí archív.

public IEnumerable<xarentry> Entries { get; }

Hodnota nehnuteľnosti

IEnumerable < XarEntry >

Methods

CreateEntries(striekačka, bool, XarCompressionSettings)

Pridajte do archívu všetky súbory a adresáre opakovane v danom adresári.

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

Parameters

sourceDirectory string

Príručka na kompresiu.

includeRootDirectory bool

Ukazuje, či zahŕňať samotný koreňový adresár alebo nie.

compressionSettings XarCompressionSettings

Kompresné nastavenia používané pre pridané položky Aspose.Zip.Xar.XarEntry.

Returns

XarArchive

Vstupná inštitúcia SR.

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

Volávač nemá požadované povolenie na prístup k sourceDirectory'.

ArgumentException

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

PathTooLongException

Ustanovená trasa, názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows musia byť trasy menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov. Ustanovená trasa, názov súboru alebo obaja sú príliš dlhé.

IOException

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

CreateEntries(DirectoryInfo, bool, XarCompressionSettings)

Pridajte do archívu všetky súbory a adresáre opakovane v danom adresári.

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

Parameters

directory DirectoryInfo

Príručka na kompresiu.

includeRootDirectory bool

Ukazuje, či zahŕňať samotný koreňový adresár alebo nie.

compressionSettings XarCompressionSettings

Kompresné nastavenia používané pre pridané položky Aspose.Zip.Xar.XarEntry.

Returns

XarArchive

Vstupná inštitúcia SR.

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

ArgumentNullException

directory’ is null.

SecurityException

Volávač nemá požadované povolenie na prístup k directory”.

IOException

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

CreateEntry(struny, FileInfo, bool, XarCompressionSettings)

Vytvorte jediný vstup v archíve.

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

Parameters

name string

Názov vstupu.

fileInfo FileInfo

Metadata súboru alebo priečinka sa majú komprimovať.

openImmediately bool

Je pravda, že ak otvoríte súbor ihneď, inak otvoríte súbor na archívnom úložisku.

compressionSettings XarCompressionSettings

Kompresné nastavenia používané pre pridanú položku Aspose.Zip.Xar.XarEntry.

Returns

XarEntry

Vstupná inštitúcia SR.

Examples

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

Remarks

Ak sa súbor otvorí okamžite s parametrom, blokuje sa až do odstránenia archívu.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(struny, struny, bool, XarCompressionSettings)

Vytvorte jediný vstup v archíve.

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

Parameters

name string

Názov vstupu.

sourcePath string

Spôsob, ako dosiahnuť, aby bol komprimovaný.

openImmediately bool

Je pravda, že ak otvoríte súbor ihneď, inak otvoríte súbor na archívnom úložisku.

compressionSettings XarCompressionSettings

Kompresné nastavenia používané pre pridanú položku Aspose.Zip.Xar.XarEntry.

Returns

XarEntry

Vstupná inštitúcia SR.

Examples

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

Remarks

Názov súboru uvedený v paramete nemá vplyv na názov súboru.

Ak sa súbor otvorí okamžite s parametrom, blokuje sa až do odstránenia archívu.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

Návštevník nemá požadované povolenie na prístup.

ArgumentException

sourcePath’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky. - alebo - Názov súboru, ako súčasť name’, presahuje 100 symbolov.

UnauthorizedAccessException

Prístup k súboru sourcePath’ je zamietnutý.

PathTooLongException

Zadaný sourcePath’, názov súboru, alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows, trasy musia byť menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov. - alebo - name’ je príliš dlhý pre xar.

NotSupportedException

Súbor v sourcePath’ obsahuje stĺpec (:) v strede riadku.

InvalidOperationException

Nie je možné zmeniť archív.

CreateEntry(striekačky, Stream, XarCompressionSettings)

Vytvorte jediný vstup v archíve.

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

Parameters

name string

Názov vstupu.

source Stream

Vstupný prúd pre vstup.

compressionSettings XarCompressionSettings

Kompresné nastavenia používané pre pridanú položku Aspose.Zip.Xar.XarEntry.

Returns

XarEntry

Vstupná inštitúcia SR.

Examples

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

Exceptions

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

name’ is empty.

InvalidOperationException

Nie je možné zmeniť archív.

DeleteEntry(XarEntry)

Odstráni prvý výskyt konkrétneho vstupu z zoznamu vstupov.

public XarArchive DeleteEntry(XarEntry entry)

Parameters

entry XarEntry

Vstup na odstránenie z zoznamu vstupov.

Returns

XarArchive

Vstupná inštitúcia SR.

Examples

Tu je, ako môžete odstrániť všetky záznamy s výnimkou posledného:

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

Exceptions

ArgumentNullException

entry’ is null.

Dispose()

Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.

public void Dispose()

Dispose(bool)

Vykonáva aplikované úlohy spojené s uvoľňovaním, uvoľňovaním alebo resetovaním neupravených zdrojov.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Mali by sa riadiť riadené zdroje.

ExtractToDirectory(Stretnutie)

Vytiahne všetky súbory v archíve do poskytnutého katalógu.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Cesta do adresára umiestniť extrahované súbory do.

Examples

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

Remarks

Ak katalóg neexistuje, vytvorí sa.

Exceptions

ArgumentNullException

Cesta je nulová

PathTooLongException

Ustanovená trasa, názov súboru alebo obaja presahujú maximálnu dĺžku definovanú systémom. Napríklad na platformách založených na systéme Windows musia byť trasy menej ako 248 znakov a názvy súborov musia byť menej ako 260 znakov.

SecurityException

Návštevník nemá požadované povolenie na prístup k existujúcemu adresáru.

NotSupportedException

Ak adresár neexistuje, cesta obsahuje znak kolónu (:) ktorý nie je súčasťou označenia disku (“C:”).

ArgumentException

Cesta je nula-dlhý pruh, obsahuje len biely priestor, alebo obsahuje jeden alebo viac neplatných znakov. Môžete požiadať o neplatné znaky pomocou metódy System.IO.Path.GetInvalidPathChars. -alebo- cesta je predpísaná s, alebo obsahuje, len znak kolónu (:).

IOException

Katalóg špecifikovaný cestou je súbor. -or- Názov siete nie je známy.

InvalidDataException

Archív je korumpovaný.

Save(Príslušenstvo, XarSaveOptions)

Uloží archív do poskytnutého cieľového súboru.

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

Parameters

destinationFileName string

Ak sa špecifikovaný názov súboru odkazuje na existujúci súbor, bude prepisovaný.

saveOptions XarSaveOptions

Možnosti uložiť xar archív s.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

Nie je možné zmeniť archív.

Save(Stream, XarSaveOptions)

Úspora archívov na poskytnutý prúd.

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

Parameters

output Stream

Cestovný prúd .

saveOptions XarSaveOptions

Možnosti uložiť xar archív s.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

Nie je možné zmeniť archív.

 Slovenčina