Class XarArchive
Nom dels espais: Aspose.Zip.Xar Assemblea: Aspose.Zip.dll (25.5.0)
Aquesta classe representa un arxiu xar.
public class XarArchive : IArchive, IDisposableInheritance
Implements
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XarArchive(XarCompressionSettings)
Inicia una nova instància de la classe Aspose.Zip.Xar.XarArchive.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parameters
defaultCompressionSettings XarCompressionSettings
La configuració de compressió estàndard, aplicada a totes les entrades de l’arxiu.
Examples
L’exemple següent mostra com comprimir un fitxer.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(Projecció, XarLoadOptions)
Inicialitza una nova instància de la classe Aspose.Zip.Xar.xarArxiu i componeix una llista d’entrada que es pot extreure de l’arxius.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parameters
sourceStream Stream
La font de l’arxiu. ha de ser buscable.
loadOptions XarLoadOptions
Les opcions per carregar arxius amb.
Examples
L’exemple següent mostra com extreure totes les entrades a un directori.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Aquest constructor no desembalca cap entrada. Veure Aspose.Zip.Xar.XarFileEntry.Open mètode per desembalcar.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid xar archive.
XarArchive(Xerrada, XarLoadOptions)
Inicialitza una nova instància de la classe Aspose.Zip.Xar.xarArxiu i componeix una llista d’entrada que es pot extreure de l’arxius.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parameters
path string
El camí cap a l’arxiu.
loadOptions XarLoadOptions
Les opcions per carregar arxius amb.
Examples
L’exemple següent mostra com extreure totes les entrades a un directori.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Aquest constructor no desembalca cap entrada. Veure Aspose.Zip.Xar.XarFileEntry.Open mètode per desembalcar.
Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
El fitxer a path’ no és l’arxiu xar vàlid.
Properties
Entries
Obté entrades del tipus Aspose.Zip.Xar.XarEntry que constitueix l’arxiu.
public IEnumerable<xarentry> Entries { get; }Valor de la propietat
IEnumerable < XarEntry >
Methods
CreateEntries(Tàrrega, Tàrrega, XarCompressionSettings)
Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
sourceDirectory string
Direcció per a la compressi.
includeRootDirectory bool
Indica si incloure o no la pròpia direcció de les arrels.
compressionSettings XarCompressionSettings
Les configuracions de compressió utilitzades per afegir elements Aspose.Zip.Xar.XarEntry.
Returns
Introducció de l’instància.
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.
El convocador no té el permís requerit per accedir a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DirectoryInfo, bool, XarCompressionSettings)
Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
directory DirectoryInfo
Direcció per a la compressi.
includeRootDirectory bool
Indica si incloure o no la pròpia direcció de les arrels.
compressionSettings XarCompressionSettings
Les configuracions de compressió utilitzades per afegir elements Aspose.Zip.Xar.XarEntry.
Returns
Introducció de l’instància.
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.
El convocador no té el permís requerit per accedir a la direcció directory'.
directory’ stands for a file, not for a directory.
CreateEntry(Llistat, FileInfo, bool, XarCompressionSettings)
Crear una entrada única dins de l’arxiu.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
El nom de l’entrada.
fileInfo FileInfo
Els metadats del fitxer o de la carpeta per a ser comprès.
openImmediately bool
s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.
compressionSettings XarCompressionSettings
Les configuracions de compressió utilitzades per afegir el element Aspose.Zip.Xar.XarEntry.
Returns
Introducció de l’instància.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}Remarks
Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(string, string, bool, XarCompressionSettings)
Crear una entrada única dins de l’arxiu.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
El nom de l’entrada.
sourcePath string
El camí per a arxiu per a ser comprès.
openImmediately bool
s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.
compressionSettings XarCompressionSettings
Les configuracions de compressió utilitzades per afegir el element Aspose.Zip.Xar.XarEntry.
Returns
Introducció de l’instància.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}Remarks
El nom d’entrada s’estableix únicament dins del paràmetre.El nom de fitxer proporcionat en el paràmetre no afecta el nom d’entrada.
Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.
Exceptions
sourcePath’ is null.
El client no té el permís d’accés requerit.
El sourcePath’ és buit, només conté espais blancs, o conté caràcters invalidats. - o - Nom de fitxer, com a part del name’, supera els 100 símbols.
L’accés al fitxer sourcePath’ es nega.
Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters. - o - name’ és massa llarg per a xar.
El fitxer a sourcePath’ conté una columna (:) al mig de la cadena.
Impossible modificar l’arxiu de xar.
CreateEntry(Llistat, Llistat, XarCompressionSettings)
Crear una entrada única dins de l’arxiu.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parameters
name string
El nom de l’entrada.
source Stream
El flux d’entrada per a l’entrada.
compressionSettings XarCompressionSettings
Les configuracions de compressió utilitzades per afegir el element Aspose.Zip.Xar.XarEntry.
Returns
Introducció de l’instància.
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.
Impossible modificar l’arxiu de xar.
DeleteEntry(XarEntry)
Elimina la primera aparició d’una entrada específica de la llista d’entrada.
public XarArchive DeleteEntry(XarEntry entry)Parameters
entry XarEntry
L’entrada per eliminar de la llista d’entrada.
Returns
Introducció de l’instància.
Examples
A continuació podeu eliminar totes les entrades excepte les últimes:
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()
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
public void Dispose()Dispose(La botiga)
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
S’han de disposar de recursos gestionats.
ExtractToDirectory(Tàrrega)
Extrata tots els arxius de l’arxiu a la direcció proporcionada.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
El camí a la direcció per col·locar els arxius extraïts.
Examples
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Si la direcció no existeix, es crear.
Exceptions
El camí és zero
Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.
El sol·licitant no té l’autorització necessària per accedir a la direcció existent.
Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“C:”).
El camí és una línia de longitud zero, només conté l’espai blanc, o conté un o més caràcters invalids. Podeu sol·licitar caràcters invalids utilitzant el mètode System.IO.Path.GetInvalidPathChars. -o- el camí està prefixat amb, o conté, només un caràcter colon (:).
El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.
L’arxiu està corromput.
Save(Xerrada, XarSaveOptions)
Salva l’arxiu al fitxer de destinació proporcionat.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parameters
destinationFileName string
El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.
saveOptions XarSaveOptions
Opcions per salvar xar arxiu amb.
Exceptions
destinationFileName’ is null.
Impossible modificar l’arxiu de xar.
Save(Projecte, XarSaveOptions)
Salva l’arxiu al corrent proporcionat.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parameters
output Stream
El flux de destinaci.
saveOptions XarSaveOptions
Opcions per salvar xar arxiu amb.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
Impossible modificar l’arxiu de xar.
