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
Implements
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
sourceStream’ is null.
sourceStream’ is not seekable.
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
path’ is null.
Návštevník nemá požadované povolenie na prístup.
path’ je prázdna, obsahuje iba biele priestory, alebo obsahuje neplatné znaky.
Prístup k súboru path" je zamietnutý.
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.
Súbor na path’ obsahuje stĺpec (:) v strede riadku.
Súbor sa nenašiel.
Uvedená trasa je neplatná, napr. byť na nezamestnanom disku.
Súbor je už otvorený.
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
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
sourceDirectory’ is null.
Volávač nemá požadované povolenie na prístup k sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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é.
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
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
directory’ is null.
Volávač nemá požadované povolenie na prístup k directory”.
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
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
name’ is null.
name’ is empty.
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
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
sourcePath’ is null.
Návštevník nemá požadované povolenie na prístup.
sourcePath’ je prázdny, obsahuje iba biele priestory, alebo obsahuje neplatné znaky. - alebo - Názov súboru, ako súčasť
name’, presahuje 100 symbolov.
Prístup k súboru sourcePath’ je zamietnutý.
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.
Súbor v sourcePath’ obsahuje stĺpec (:) v strede riadku.
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
Vstupná inštitúcia SR.
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.
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
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 > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}
Exceptions
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
Cesta je nulová
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.
Návštevník nemá požadované povolenie na prístup k existujúcemu adresáru.
Ak adresár neexistuje, cesta obsahuje znak kolónu (:) ktorý nie je súčasťou označenia disku (“C:”).
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 (:).
Katalóg špecifikovaný cestou je súbor. -or- Názov siete nie je známy.
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
destinationFileName’ is null.
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
output’ is null.
output’Is not writable/readable or not seekable.
Nie je možné zmeniť archív.