Class XarArchive
Nombre del espacio: Aspose.Zip.Xar Asamblea: Aspose.Zip.dll (25.5.0)
Esta clase representa un archivo xar.
public class XarArchive : IArchive, IDisposableInheritance
Implements
IArchive ,y, IDisposable
Miembros heredados
object.GetType() ,y, object.MemberwiseClone() ,y, object.ToString() ,y, object.Equals(object?) ,y, object.Equals(object?, object?) ,y, object.ReferenceEquals(object?, object?) ,y, object.GetHashCode()
Constructors
XarArchive(XarCompressionSettings)
Inicia una nueva instancia de la clase Aspose.Zip.Xar.XarArchive.
public XarArchive(XarCompressionSettings defaultCompressionSettings = null)Parameters
defaultCompressionSettings XarCompressionSettings
La configuración de compresión por defecto, aplicada a todas las entradas del archivo.
Examples
El siguiente ejemplo muestra cómo comprimir un archivo.
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}XarArchive(El flujo, XarLoadOptions)
Inicia una nueva instancia de la clase Aspose.Zip.Xar.xarArchive y compone una lista de entradas que se puede extraer del archivo.
public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)Parameters
sourceStream Stream
La fuente del archivo. debe ser buscable.
loadOptions XarLoadOptions
Las opciones para cargar archivos con.
Examples
El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.
using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Este constructor no desembala ninguna entrada. Ver Aspose.Zip.Xar.XarFileEntry.Open método para desembalaje.
Exceptions
sourceStream’ is null.
sourceStream’ is not seekable.
sourceStream’ is not valid xar archive.
XarArchive(Título: XarLoadOptions)
Inicia una nueva instancia de la clase Aspose.Zip.Xar.xarArchive y compone una lista de entradas que se puede extraer del archivo.
public XarArchive(string path, XarLoadOptions loadOptions = null)Parameters
path string
El camino hacia el archivo.
loadOptions XarLoadOptions
Las opciones para cargar archivos con.
Examples
El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Este constructor no desembala ninguna entrada. Ver Aspose.Zip.Xar.XarFileEntry.Open método para desembalaje.
Exceptions
path’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.
Se denega el acceso al archivo path.
La ruta path", nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres.
El archivo en path’ contiene una columna (:) en el medio de la línea.
El archivo no se encuentra.
La ruta especificada es invalida, como estar en un disco no mapeado.
El archivo ya está abierto.
El archivo en path" no es válido.
Properties
Entries
Obtiene entradas del tipo Aspose.Zip.Xar.XarEntry que constituye el archivo.
public IEnumerable<xarentry> Entries { get; }Valor de la propiedad
IEnumerable &ylt; XarEntry >
Methods
CreateEntries(Síntomas, Síntomas, XarCompressionSettings)
Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.
public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
sourceDirectory string
Directorios para compresión.
includeRootDirectory bool
Indica si incluir el directorio de raíz mismo o no.
compressionSettings XarCompressionSettings
Las configuraciones de compresión utilizadas para agregar elementos Aspose.Zip.Xar.XarEntry.
Returns
Introducción a la instancia.
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 llamador no tiene el permiso necesario para acceder a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
El camino especificado, el nombre de archivo, o ambos excede la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.
sourceDirectory’ stands for a file, not for a directory.
CreateEntries(DirectoryInfo, bool, XarCompressionSettings)
Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.
public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)Parameters
directory DirectoryInfo
Directorios para compresión.
includeRootDirectory bool
Indica si incluir el directorio de raíz mismo o no.
compressionSettings XarCompressionSettings
Las configuraciones de compresión utilizadas para agregar elementos Aspose.Zip.Xar.XarEntry.
Returns
Introducción a la instancia.
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 llamador no tiene el permiso necesario para acceder a la directory'.
directory’ stands for a file, not for a directory.
CreateEntry(Título, FileInfo, Bool, XarCompressionSettings)
Crea una entrada única dentro del archivo.
public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
El nombre de la entrada.
fileInfo FileInfo
Los metadatos del archivo o de la carpeta para ser comprimido.
openImmediately bool
Es cierto, si se abre el archivo de inmediato, de lo contrario se abre el archivo en el archivo de almacenamiento.
compressionSettings XarCompressionSettings
Las configuraciones de compresión utilizadas para agregar el elemento Aspose.Zip.Xar.XarEntry.
Returns
Introducción a la instancia.
Examples
FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
archive.CreateEntry("test.bin", fileInfo);
archive.Save("archive.xar");
}Remarks
Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.
Exceptions
name’ is null.
name’ is empty.
fileInfo’ is null.
CreateEntry(Síntomas, Síntomas, Bool, XarCompressionSettings)
Crea una entrada única dentro del archivo.
public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)Parameters
name string
El nombre de la entrada.
sourcePath string
El camino para que el archivo sea comprimido.
openImmediately bool
Es cierto, si se abre el archivo de inmediato, de lo contrario se abre el archivo en el archivo de almacenamiento.
compressionSettings XarCompressionSettings
Las configuraciones de compresión utilizadas para agregar el elemento Aspose.Zip.Xar.XarEntry.
Returns
Introducción a la instancia.
Examples
using (var archive = new XarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.xar");
}Remarks
El nombre de entrada se establece únicamente dentro del parámetro.El nombre de archivo proporcionado en el parámetro no afecta al nombre de entrada.
Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.
Exceptions
sourcePath’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El sourcePath’ es vacío, contiene sólo espacios blancos, o contiene caracteres invalidos. - o - Nombre de archivo, como parte del name’, supera los 100 símbolos.
El acceso al archivo sourcePath’ se denega.
La sourcePath’, nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres. - o - name’ es demasiado largo para xar.
El archivo en sourcePath’ contiene una columna (:) en el medio de la línea.
No se puede modificar el archivo.
CreateEntry(SiguienteSiguienteSiguienteSiguienteSiguienteSiguiente XarCompressionSettings)
Crea una entrada única dentro del archivo.
public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)Parameters
name string
El nombre de la entrada.
source Stream
El flujo de entrada para la entrada.
compressionSettings XarCompressionSettings
Las configuraciones de compresión utilizadas para agregar el elemento Aspose.Zip.Xar.XarEntry.
Returns
Introducción a la instancia.
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.
No se puede modificar el archivo.
DeleteEntry(XarEntry)
Elimina la primera aparición de una entrada específica de la lista de entrada.
public XarArchive DeleteEntry(XarEntry entry)Parameters
entry XarEntry
La entrada a eliminar de la lista de entradas.
Returns
Introducción a la instancia.
Examples
Aquí está cómo puedes eliminar todas las entradas excepto la última:
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()
Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.
public void Dispose()Dispose(BOOL)
Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Los recursos gestionados deben ser eliminados.
ExtractToDirectory(El string)
Extracta todos los archivos en el directorio proporcionado.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
El camino hacia el directorio para colocar los archivos extraídos.
Examples
using (var archive = new XarArchive("archive.xar"))
{
archive.ExtractToDirectory("C:\\extracted");
}Remarks
Si el directorio no existe, se crear.
Exceptions
El camino es nulo
Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.
El llamador no tiene el permiso necesario para acceder al directorio existente.
Si el directorio no existe, el camino contiene un carácter colon (:) que no forma parte de una etiqueta de disco (“C:”).
El camino es una línea de longitud cero, contiene sólo espacio blanco, o contiene uno o más caracteres invalidos.Puede solicitar los caracteres invalidos utilizando el método System.IO.Path.GetInvalidPathChars. -o- el camino está prefixado con, o contiene, sólo un caracter colon (:).
El directorio especificado por ruta es un archivo. -o- El nombre de red no es conocido.
El archivo está corrupto.
Save(Título: XarSaveOptions)
Salva archivo al archivo de destino proporcionado.
public void Save(string destinationFileName, XarSaveOptions saveOptions = null)Parameters
destinationFileName string
Si el nombre de archivo especificado indica a un archivo existente, se reescribir.
saveOptions XarSaveOptions
Opciones para guardar archivos de xar con.
Exceptions
destinationFileName’ is null.
No se puede modificar el archivo.
Save(El flujo, XarSaveOptions)
Salva archivos a la corriente proporcionada.
public void Save(Stream output, XarSaveOptions saveOptions = null)Parameters
output Stream
El flujo de destino.
saveOptions XarSaveOptions
Opciones para guardar archivos de xar con.
Exceptions
output’ is null.
output’Is not writable/readable or not seekable.
No se puede modificar el archivo.
