Class XarArchive

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

`XarArchive(Cuvânt cheie, XarLoadOptions)`

Inițializează o nouă instanță a clasei Aspose.Zip.Xar.xarArchive și compune o listă de intrări care poate fi extras din arhivă.

public XarArchive(string path, XarLoadOptions loadOptions = null)

`Parameters`

path string

Calea către arhivă.

loadOptions XarLoadOptions

Opțiunile de încărcare a arhivelor cu.

`Examples`

Următorul exemplu arată cum să extrageți toate intrările într-un director.

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

`Remarks`

Acest constructor nu dezpacteaza nici o intrare. Vezi Aspose.Zip.Xar.XarFileEntry.Open metoda pentru dezpacteaza.

`Exceptions`

path’ is null.

Solicitantul nu are permisiunea necesară de acces.

UnauthorizedAccessException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

Accesul la fișierul path" este refuzat.

DirectoryNotFoundException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

FileNotFoundException

Dosarul nu a fost găsit.

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

Dosarul este deja deschis.

InvalidDataException

Fișierul la path" nu este valabil pentru arhiva xar.

`Properties`

`Entries`

Obține intrări de tip Aspose.Zip.Xar.XarEntry care constituie arhiva.

public IEnumerable<xarentry> Entries { get; }

`Valoarea proprietății`

IEnumerable < XarEntry >

`Methods`

`CreateEntries(string, bool, XarCompressionSettings)`

Adăugați în arhiv toate fișierele și directorii în mod recurent în directorul dat.

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

`Parameters`

sourceDirectory string

Directoare pentru compresă.

includeRootDirectory bool

Indică dacă să includă directorul de rădăcină în sine sau nu.

compressionSettings XarCompressionSettings

Setările de compresie utilizate pentru a adăuga elemente Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

intrarea în instanţă.

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

Solicitantul nu are permisiunea necesară pentru a accesa sourceDirectory'.

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

Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere. Calea specificată, numele fișierului sau ambele sunt prea lungi.

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

`CreateEntries(DirectoryInfo, bool, XarCompressionSettings)`

Adăugați în arhiv toate fișierele și directorii în mod recurent în directorul dat.

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

`Parameters`

directory DirectoryInfo

Directoare pentru compresă.

includeRootDirectory bool

Indică dacă să includă directorul de rădăcină în sine sau nu.

compressionSettings XarCompressionSettings

Setările de compresie utilizate pentru a adăuga elemente Aspose.Zip.Xar.XarEntry.

`Returns`

XarArchive

intrarea în instanţă.

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

Solicitantul nu are permisiunea necesară pentru a accesa directory”.

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

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

Creați o singură intrare în arhivă.

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

`Parameters`

name string

Numele intrării.

fileInfo FileInfo

Metadata fișierului sau a folderului trebuie să fie compresă.

openImmediately bool

Adevărat, dacă deschideți imediat fișierul, în caz contrar deschideți fișierul pe stocarea arhivelor.

compressionSettings XarCompressionSettings

Setările de compresie utilizate pentru a adăuga elementul Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

intrarea în instanţă.

`Examples`

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

`Remarks`

Dacă fișierul este deschis imediat cu parametru, acesta este blocat până când arhiva este eliminată.

`Exceptions`

name’ is null.

name’ is empty.

fileInfo’ is null.

`CreateEntry(string, string, bool, XarCompressionSettings)`

Creați o singură intrare în arhivă.

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

`Parameters`

name string

Numele intrării.

sourcePath string

Calea pentru a fi compresat.

openImmediately bool

Adevărat, dacă deschideți imediat fișierul, în caz contrar deschideți fișierul pe stocarea arhivelor.

compressionSettings XarCompressionSettings

Setările de compresie utilizate pentru a adăuga elementul Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

intrarea în instanţă.

`Examples`

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

`Remarks`

Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.

Dacă fișierul este deschis imediat cu parametru, acesta este blocat până când arhiva este eliminată.

`Exceptions`

sourcePath’ is null.

Solicitantul nu are permisiunea necesară de acces.

UnauthorizedAccessException

sourcePath’ este gol, conține doar spații albe sau conține caractere invalide. - sau - Numele fișierului, ca parte a name’, depășește 100 de simboluri.

Accesul la fișierul sourcePath’ este refuzat.

De exemplu, pe platforme bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere. - sau - name’ este prea lung pentru xar.

NotSupportedException

Fișierul la sourcePath’ conține o coloană (:) în mijlocul stringului.

Nu este posibilă modificarea arhivelor.

`CreateEntry(Strângere, Strângere, XarCompressionSettings)`

Creați o singură intrare în arhivă.

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

`Parameters`

name string

Numele intrării.

source Stream

Rata de intrare pentru intrare.

compressionSettings XarCompressionSettings

Setările de compresie utilizate pentru a adăuga elementul Aspose.Zip.Xar.XarEntry.

`Returns`

XarEntry

intrarea în instanţă.

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

Nu este posibilă modificarea arhivelor.

`DeleteEntry(XarEntry)`

Elimină prima apariție a unei intrări specifice din lista de intrări.

public XarArchive DeleteEntry(XarEntry entry)

`Parameters`

entry XarEntry

Introducere pentru a elimina din lista de intrări.

`Returns`

XarArchive

intrarea în instanţă.

`Examples`

Iată cum puteți șterge toate intrările, cu excepția celei din urmă:

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

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

public void Dispose()

`Dispose(Boulă)`

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

În cazul în care resursele gestionate ar trebui să fie eliminate.

`ExtractToDirectory(Strângere)`

Extrage toate fișierele din arhivă în directorul furnizat.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Calea către directorie pentru a pune în fișierele extrase.

`Examples`

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

`Remarks`

Dacă directorul nu există, acesta va fi creat.

`Exceptions`

Calea este zero

Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.

NotSupportedException

Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă de disc (“C:”).

Putea este o linie de lungime zero, conține doar spațiu alb, sau conține unul sau mai multe caractere invalide. puteți solicita caractere invalide folosind metoda System.IO.Path.GetInvalidPathChars. -or- Putea este prefixată cu, sau conține, doar un caracter colon (:).

Directoriul specificat de cale este un fișier. -or- Numele rețelei nu este cunoscut.

InvalidDataException

Arhiva este coruptă.

`Save(Cuvânt cheie, XarSaveOptions)`

Salvează arhiva la fișierul de destinație furnizat.

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

`Parameters`

destinationFileName string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

saveOptions XarSaveOptions

Opțiuni pentru a salva arhiva xar cu.

`Exceptions`

destinationFileName’ is null.

Nu este posibilă modificarea arhivelor.

`Save(Cuvânt cheie, XarSaveOptions)`

Salvează arhiva la fluxul furnizat.

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

`Parameters`

output Stream

Războiul de destinaţie.

saveOptions XarSaveOptions

Opțiuni pentru a salva arhiva xar cu.

`Exceptions`

output’ is null.

output’Is not writable/readable or not seekable.