Class XarArchive

Class XarArchive

ja nimityö: Aspose.Zip.Xar Kokoelma: Aspose.Zip.dll (25.5.0)

Tämä luokka edustaa xar arkistotiedostoa.

public class XarArchive : IArchive, IDisposable

Inheritance

object XarArchive

Implements

IArchive , IDisposable

Perintöjäsenet

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

Constructors

XarArchive(XarCompressionSettings)

Aloittaa Aspose.Zip.Xar.XarArchive -luokan uusi esimerkki.

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

Oletusarvoiset kompressiasetukset, joita sovelletaan kaikkiin arkiston kirjoituksiin.

Examples

Seuraava esimerkki osoittaa, miten tiedostoa puristetaan.

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

XarArchive(Virtaa, XarLoadOptions)

Aloitetaan uusi esimerkki Aspose.Zip.Xar.xarArchive luokka ja koostuu luettelo, joka voidaan poistaa arkistosta.

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

Arkiston lähde. se on etsimätön.

loadOptions XarLoadOptions

Vaihtoehtoja arkiston lataamiseen.

Examples

Seuraava esimerkki osoittaa, miten poistaa kaikki merkinnät direktoriin.

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

Remarks

Tämä rakentaja ei poista mitään sisäänkäyntiä. Katso Aspose.Zip.Xar.XarFileEntry.Open menetelmä poista.

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(Tarjolla, XarLoadOptions)

Aloitetaan uusi esimerkki Aspose.Zip.Xar.xarArchive luokka ja koostuu luettelo, joka voidaan poistaa arkistosta.

public XarArchive(string path, XarLoadOptions loadOptions = null)

Parameters

path string

Tietä arkistoon tiedostoon.

loadOptions XarLoadOptions

Vaihtoehtoja arkiston lataamiseen.

Examples

Seuraava esimerkki osoittaa, miten poistaa kaikki merkinnät direktoriin.

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

Remarks

Tämä rakentaja ei poista mitään sisäänkäyntiä. Katso Aspose.Zip.Xar.XarFileEntry.Open menetelmä poista.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

FileNotFoundException

Tiedostoa ei löydy.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

IOException

Tiedosto on jo auki.

InvalidDataException

Tiedosto path’ ei ole voimassa xar arkisto.

Properties

Entries

Saat talletuksia Aspose.Zip.Xar.XarEntry -tyyppistä, joka muodostaa arkiston.

public IEnumerable<xarentry> Entries { get; }

Omistuksen arvo

IEnumerable < XarEntry >

Methods

CreateEntries(linnoitus, bool, XarCompressionSettings)

Lisää arkistoon kaikki tiedostot ja luettelot toistuvasti annetussa luettelossa.

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

Parameters

sourceDirectory string

Ohjelma on kompressi.

includeRootDirectory bool

Se osoittaa, sisällytetäänkö root-direktiivi itse vai ei.

compressionSettings XarCompressionSettings

Kompressioasetukset käytetään lisäämään Aspose.Zip.Xar.XarEntry kohteita.

Returns

XarArchive

Sisäänkäyntiä koskeva viranomainen.

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

Soittajalle ei ole tarvittavaa lupaa käyttää sourceDirectory'.

ArgumentException

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

PathTooLongException

Tietyt reitit, tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla reitit on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

IOException

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

CreateEntries(DirectoryInfo, bool, XarCompressionSettings)

Lisää arkistoon kaikki tiedostot ja luettelot toistuvasti annetussa luettelossa.

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

Parameters

directory DirectoryInfo

Ohjelma on kompressi.

includeRootDirectory bool

Se osoittaa, sisällytetäänkö root-direktiivi itse vai ei.

compressionSettings XarCompressionSettings

Kompressioasetukset käytetään lisäämään Aspose.Zip.Xar.XarEntry kohteita.

Returns

XarArchive

Sisäänkäyntiä koskeva viranomainen.

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

Soittajalle ei ole tarvittavaa lupaa käyttää direktiiviä”.

IOException

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

CreateEntry(sarja, FileInfo, bool, XarCompressionSettings)

Luo yksi kirja arkiston sisällä.

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

Parameters

name string

Sisäänkäynnin nimi.

fileInfo FileInfo

Tiedoston tai tiedoston metatiedot tulee kompressoida.

openImmediately bool

Totuus, jos avaat tiedoston välittömästi, muuten avaa tiedosto arkiston tallennuksessa.

compressionSettings XarCompressionSettings

Kompressioasetukset käytetään lisäämään Aspose.Zip.Xar.XarEntry elementti.

Returns

XarEntry

Sisäänkäyntiä koskeva viranomainen.

Examples

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

Remarks

Jos tiedosto avautuu välittömästi parametrien avulla, se estetään, kunnes arkisto poistetaan.

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(sarja, sarja, bool, XarCompressionSettings)

Luo yksi kirja arkiston sisällä.

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

Parameters

name string

Sisäänkäynnin nimi.

sourcePath string

Matka tiedostoon kompresoida.

openImmediately bool

Totuus, jos avaat tiedoston välittömästi, muuten avaa tiedosto arkiston tallennuksessa.

compressionSettings XarCompressionSettings

Kompressioasetukset käytetään lisäämään Aspose.Zip.Xar.XarEntry elementti.

Returns

XarEntry

Sisäänkäyntiä koskeva viranomainen.

Examples

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

Remarks

Sisällön nimi asetetaan vain parametrien sisällä. parametriin annettu tiedoston nimi ei vaikuta sisällön nimiin.

Jos tiedosto avautuu välittömästi parametrien avulla, se estetään, kunnes arkisto poistetaan.

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

sourcePath’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä. - tai - Tiedoston nimi, osana name’, ylittää 100 merkkiä.

UnauthorizedAccessException

Pääsy sourcePath’ -tiedostoon kielletään.

PathTooLongException

Tietyt sourcePath’, tiedoston nimi, tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisissa alustoissa, reitit on oltava alle 248 merkkiä, ja tiedoston nimet on oltava alle 260 merkkiä. - tai - name’ on liian pitkä xar.

NotSupportedException

sourcePath’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

InvalidOperationException

Arkistoa ei voi muuttaa.

CreateEntry(virtaa, virtaa, XarCompressionSettings)

Luo yksi kirja arkiston sisällä.

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

Parameters

name string

Sisäänkäynnin nimi.

source Stream

Sisäänpääsy virtaa sisäänpääsyyn.

compressionSettings XarCompressionSettings

Kompressioasetukset käytetään lisäämään Aspose.Zip.Xar.XarEntry elementti.

Returns

XarEntry

Sisäänkäyntiä koskeva viranomainen.

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

Arkistoa ei voi muuttaa.

DeleteEntry(XarEntry)

Poistaa tietyn ilmoituksen ensimmäinen esiintyminen ilmoitusluettelosta.

public XarArchive DeleteEntry(XarEntry entry)

Parameters

entry XarEntry

Sisäänpäätökset poistetaan luettelosta.

Returns

XarArchive

Sisäänkäyntiä koskeva viranomainen.

Examples

Tässä, miten voit poistaa kaikki kirjoitukset lukuun ottamatta viimeistä:

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

Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.

public void Dispose()

Dispose(Booli)

Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Hallittuja resursseja on käytettävä.

ExtractToDirectory(String)

Poistaa kaikki tiedostot arkistosta annettuun luetteloon.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Matka direktoriin sijoittaa poistettuja tiedostoja.

Examples

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

Remarks

Jos rekisteri ei ole olemassa, se luodaan.

Exceptions

ArgumentNullException

Matka on nolla

PathTooLongException

Tietyt reitit, tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisissa alustoissa reitit on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

SecurityException

Kääntäjällä ei ole tarvittavaa lupaa käyttää olemassa olevaa direktoria.

NotSupportedException

Jos luetteloa ei ole olemassa, reitillä on rintakehän merkki (:) joka ei ole osa ohjaimen merkkiä (“C:”).

ArgumentException

polku on nollan pituinen sarja, sisältää vain valkoista tilaa, tai sisältää yhden tai useamman epätasaisen merkkiä. Voit hakea epätasaisia merkkejä käyttämällä System.IO.Path.GetInvalidPathChars menetelmää. -tai- polku on etukäteen määritelty, tai sisältää vain kolumn merkkiä (:).

IOException

Reitin mukainen luettelo on tiedosto. -or- Verkon nimi ei ole tiedossa.

InvalidDataException

Arkisto on korruptoitu.

Save(Tarjolla, XarSaveOptions)

Tallenna arkistoa osoitustiedostoon.

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

Parameters

destinationFileName string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

saveOptions XarSaveOptions

Vaihtoehdot tallentaa xar arkiston kanssa.

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

Arkistoa ei voi muuttaa.

Save(Virtaa, XarSaveOptions)

Säästää arkistoa tarjottuun virtaukseen.

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

Parameters

output Stream

Tavoitteen virta.

saveOptions XarSaveOptions

Vaihtoehdot tallentaa xar arkiston kanssa.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

Arkistoa ei voi muuttaa.

 Suomi