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
Implements
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
sourceStream’ is null.
sourceStream’ is not seekable.
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
path’ is null.
Kääntäjällä ei ole tarvittavaa käyttöoikeutta.
path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.
Pääsy path" -tiedostoon kielletään.
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ä.
path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.
Tiedostoa ei löydy.
Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.
Tiedosto on jo auki.
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
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
sourceDirectory’ is null.
Soittajalle ei ole tarvittavaa lupaa käyttää sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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ä.
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
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
directory’ is null.
Soittajalle ei ole tarvittavaa lupaa käyttää direktiiviä”.
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
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
name’ is null.
name’ is empty.
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
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
sourcePath’ is null.
Kääntäjällä ei ole tarvittavaa käyttöoikeutta.
sourcePath’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä. - tai - Tiedoston nimi, osana
name’, ylittää 100 merkkiä.
Pääsy sourcePath’ -tiedostoon kielletään.
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.
sourcePath’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.
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
Sisäänkäyntiä koskeva viranomainen.
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.
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
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 > 1)
archive.DeleteEntry(archive.Entries.FirstOrDefault());
archive.Save(outputXarFile);
}
Exceptions
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
Matka on nolla
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ä.
Kääntäjällä ei ole tarvittavaa lupaa käyttää olemassa olevaa direktoria.
Jos luetteloa ei ole olemassa, reitillä on rintakehän merkki (:) joka ei ole osa ohjaimen merkkiä (“C:”).
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ä (:).
Reitin mukainen luettelo on tiedosto. -or- Verkon nimi ei ole tiedossa.
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
destinationFileName’ is null.
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
output’ is null.
output’Is not writable/readable or not seekable.
Arkistoa ei voi muuttaa.