Class XarArchive
nazivni prostor: Aspose.Zip.Xar Sastav: Aspose.Zip.dll (25.5.0)
Ova klasa predstavlja arhivsku datoteku xar.
public class XarArchive : IArchive, IDisposableInheritance
Implements
naslijeđeni članovi
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XarArchive(XarCompressionSettings)
Inicijalizira novu primjenu klase Aspose.Zip.Xar.XarArchive.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parameters
defaultCompressionSettings XarCompressionSettings
Podrazumevane postavke kompresije, primjenjuju se na sve uloge u arhivu.
Examples
Sljedeći primjer pokazuje kako komprimirati datoteku.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(Slijedeći članakStraam, XarLoadOptions)
Inicijalizira novu primjenu Aspose.Zip.Xar.xarArhiv razreda i sastavlja popis ulazaka koji se može izvući iz arhiva.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parameters
sourceStream Stream
Izvor arhiva mora biti tražljiv.
loadOptions XarLoadOptions
Opcije za preuzimanje arhiva s.
Examples
Sljedeći primjer pokazuje kako izvući sve uloge u direktoriju.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Ovaj proizvođač ne otpušta nikakve ulaznice. pogledajte Aspose.Zip.Xar.XarFileEntry.Otvoren način za otpuštanje.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid xar archive.
XarArchive(Sljedeći Članak XarLoadOptions)
Inicijalizira novu primjenu Aspose.Zip.Xar.xarArhiv razreda i sastavlja popis ulazaka koji se može izvući iz arhiva.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parameters
path string
Put do arhivske datoteke.
loadOptions XarLoadOptions
Opcije za preuzimanje arhiva s.
Examples
Sljedeći primjer pokazuje kako izvući sve uloge u direktoriju.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Ovaj proizvođač ne otpušta nikakve ulaznice. pogledajte Aspose.Zip.Xar.XarFileEntry.Otvoren način za otpuštanje.
Exceptions
path’ is null.
Pozivač nema potrebnu dozvolu za pristup.
path’ je prazan, sadrži samo bijele prostore, ili sadrži nevažeće znakove.
Pristup datoteci path" je odbijen.
Na primjer, na Windows platformama, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova.
File na path’ sadrži kolona (:) u sredini trake.
Dosje nije pronađeno.
Navedeni put je nevažeći, na primjer, biti na nemapiranom pogonu.
Dosje je već otvoreno.
File u path’ nije valjan arhiv xar.
Properties
Entries
Dobiva ulaznice tipa Aspose.Zip.Xar.XarEntry koji čine arhiv.
public IEnumerable<xarentry> Entries { get; }Vrijednost nekretnina
IEnumerable < XarEntry >
Methods
CreateEntries(šipka, bool, XarCompressionSettings)
Dodajte u arhiv sve datoteke i zapise ponavljajući se u određenom zapisu.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
sourceDirectory string
Direktorat za kompresije.
includeRootDirectory bool
To ukazuje na to treba li uključiti sam korijenski katalog ili ne.
compressionSettings XarCompressionSettings
Kompresijske postavke koje se koriste za dodavanje Aspose.Zip.Xar.XarEntry predmeta.
Returns
Ulaznica za ulazak.
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.
Pozivač nema potrebnu dozvolu za pristup sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Na primjer, na Windows platformama, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DirektorijInfo, bool, XarCompressionSettings)
Dodajte u arhiv sve datoteke i zapise ponavljajući se u određenom zapisu.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
directory DirectoryInfo
Direktorat za kompresije.
includeRootDirectory bool
To ukazuje na to treba li uključiti sam korijenski katalog ili ne.
compressionSettings XarCompressionSettings
Kompresijske postavke koje se koriste za dodavanje Aspose.Zip.Xar.XarEntry predmeta.
Returns
Ulaznica za ulazak.
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.
Pozivač nema potrebnu dozvolu za pristup directory”.
directory’ stands for a file, not for a directory.
CreateEntry(string, FileInfo, bool, XarCompressionSettings)
Stvorite jedinstvenu ulaznicu u arhivu.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
Naziv ulaznice.
fileInfo FileInfo
Metapodatke datoteke ili mape koje treba komprimirati.
openImmediately bool
Istina, ako odmah otvorite datoteku, inače otvorite datoteku na arhivskom skladištenju.
compressionSettings XarCompressionSettings
Kompresijske postavke koje se koriste za dodavanje Aspose.Zip.Xar.XarEntry elementa.
Returns
Ulaznica za ulazak.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}Remarks
Ako se datoteka odmah otvori s parametrom, blokira se sve dok se arhiv ne ukloni.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(string, string, bool, XarCompressionSettings)
Stvorite jedinstvenu ulaznicu u arhivu.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
Naziv ulaznice.
sourcePath string
Slijedeći članakSlijedeći članakSlijedeći članakSlijedeći članakSlijedeći članakSlijedeće →
openImmediately bool
Istina, ako odmah otvorite datoteku, inače otvorite datoteku na arhivskom skladištenju.
compressionSettings XarCompressionSettings
Kompresijske postavke koje se koriste za dodavanje Aspose.Zip.Xar.XarEntry elementa.
Returns
Ulaznica za ulazak.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}Remarks
Naziv ulaza je postavljen isključivo unutar parametara. ime datoteke navedeno u parametru ne utječe na ime ulaza.
Ako se datoteka odmah otvori s parametrom, blokira se sve dok se arhiv ne ukloni.
Exceptions
sourcePath’ is null.
Pozivač nema potrebnu dozvolu za pristup.
sourcePath’ je prazan, sadrži samo bijele prostore, ili sadrži nevažeće znakove. - ili - Ime datoteke, kao dio name’, premašuje 100 simbola.
Pristup datoteci sourcePath’ je odbijen.
Na primjer, na Windows platformama, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova. - ili - name’ je previše dugo za xar.
File u sourcePath’ sadrži kolona (:) u sredini trake.
Nemoguće je izmijeniti arhiv.
CreateEntry(String, struja, XarCompressionSettings)
Stvorite jedinstvenu ulaznicu u arhivu.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parameters
name string
Naziv ulaznice.
source Stream
Ulaznice za ulaz.
compressionSettings XarCompressionSettings
Kompresijske postavke koje se koriste za dodavanje Aspose.Zip.Xar.XarEntry elementa.
Returns
Ulaznica za ulazak.
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.
Nemoguće je izmijeniti arhiv.
DeleteEntry(XarEntry)
Ukloni prvu pojavu određenog ulaza s popisa ulaza.
public XarArchive DeleteEntry(XarEntry entry)Parameters
entry XarEntry
Ulazak treba ukloniti s popisa ulazaka.
Returns
Ulaznica za ulazak.
Examples
Evo kako možete ukloniti sve prijave osim posljednjeg:
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()
On obavlja zadatke definirane po aplikaciji povezane s oslobađanjem, oslobađanjem ili ponovnim oslobađanjem nekontroliranih resursa.
public void Dispose()Dispose(Bolić)
On obavlja zadatke definirane po aplikaciji povezane s oslobađanjem, oslobađanjem ili ponovnim oslobađanjem nekontroliranih resursa.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Treba li iskoristiti upravljane resurse.
ExtractToDirectory(String)
Izvadite sve datoteke u arhivu u pruženi direktorij.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Put do direktora za stavljanje izvedenih datoteka u.
Examples
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Ako direktorija ne postoji, stvorit će se.
Exceptions
Cesta je nula
Na primjer, na Windows platformama, staze moraju biti manje od 248 znakova, a imena datoteke moraju biti manje od 260 znakova.
Pozivač nema potrebnu dozvolu za pristup postojećem adresaru.
Ako direktorija ne postoji, put sadrži znak kolona (:) koji nije dio oznake pogona (“C:”).
put je nula-dužina traka, sadrži samo bijeli prostor, ili sadrži jedan ili više nevažećih znakova. možete tražiti za nevažeće znakove pomoću metode System.IO.Path.GetInvalidPathChars. -or- put je unaprijed postavljen s, ili sadrži, samo znak kolona (:).
Direktorija određena putem je datoteka. -ili- Ime mreže nije poznato.
Arhiva je korumpirana.
Save(Sljedeći Članak XarSaveOptions)
Sačuvajte arhiv za dostavljenu dosjeu odredišta.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parameters
destinationFileName string
Ako određeno ime datoteke ukazuje na postojeće datoteke, to će biti prepisano.
saveOptions XarSaveOptions
Opcije za spašavanje xar arhiva s.
Exceptions
destinationFileName’ is null.
Nemoguće je izmijeniti arhiv.
Save(Slijedeći članakStraam, XarSaveOptions)
Sačuvajte arhiv na pruženi tok.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parameters
output Stream
Odredište za tok.
saveOptions XarSaveOptions
Opcije za spašavanje xar arhiva s.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
Nemoguće je izmijeniti arhiv.
