Class TarArchive

Class TarArchive

Nombre del espacio: Aspose.Zip.Tar Asamblea: Aspose.Zip.dll (25.5.0)

Esta clase representa un archivo de tar. Utilice para compilar, extraer o actualizar archivos de Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

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

TarArchive()

Inicia una nueva instancia de la clase Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

El siguiente ejemplo muestra cómo comprimir un archivo.

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

TarArchive(Stream)

Inicializa una nueva instancia de la clase Aspose.Zip.Archive y compone una lista de entradas que se puede extraer del archivo.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

La fuente del archivo. debe ser buscable.

Examples

El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.

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

Remarks

Este constructor no desembala ninguna entrada. Ver Aspose.Zip.Tar.TarEntry.Método abierto para desembala.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(El string)

Inicia una nueva instancia de la clase Aspose.Zip.tar.TarArchive y compone una lista de entradas que se puede extraer del archivo.

public TarArchive(string path)

Parameters

path string

El camino hacia el archivo.

Examples

El siguiente ejemplo muestra cómo extraer todas las entradas a un directorio.

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

Remarks

Este constructor no desembala ninguna entrada. Ver Aspose.Zip.Tar.TarEntry.Método abierto para desembala.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El solicitante no tiene la autorización necesaria para acceder.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path’ contiene una columna (:) en el medio de la línea.

FileNotFoundException

El archivo no se encuentra.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

IOException

El archivo ya está abierto.

Properties

Entries

Obtiene entradas del tipo Aspose.Zip.Tar.TarEntry que constituye el archivo.

public ReadOnlyCollection<tarentry> Entries { get; }

Valor de la propiedad

ReadOnlyCollection &ylt; TarEntry >

Methods

CreateEntries(Siguiente Entrada siguiente: Bool)

Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

Parameters

directory DirectoryInfo

Directorios para compresión.

includeRootDirectory bool

Indica si incluir el directorio de raíz mismo o no.

Returns

TarArchive

El archivo con entradas compuestas.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(tarFile);
    }
}

CreateEntries(Cortesía, Bool)

Ads al archivo todos los archivos y directorios recurrentemente en el directorio dado.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Parameters

sourceDirectory string

Directorios para compresión.

includeRootDirectory bool

Indica si incluir el directorio de raíz mismo o no.

Returns

TarArchive

El archivo con entradas compuestas.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

El llamador no tiene el permiso necesario para acceder a sourceDirectory'.

ArgumentException

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

PathTooLongException

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.

CreateEntry(Título: Stream, FileSystemInfo)

Crea una entrada única dentro del archivo.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Parameters

name string

El nombre de la entrada.

source Stream

El flujo de entrada para la entrada.

fileInfo FileSystemInfo

Los metadatos del archivo o de la carpeta para ser comprimido.

Returns

TarEntry

Introducción a la instancia.

Examples

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

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.

puede referirse a System.IO.DirectoryInfo si la entrada es directorio.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

El nombre del archivo, como parte de la name’, supera los 100 símbolos.

CreateEntry(Archivo de la etiqueta: FileInfo, Bool)

Crea una entrada única dentro del archivo.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

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.

Returns

TarEntry

Introducción a la instancia.

Examples

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

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.

puede referirse a System.IO.DirectoryInfo si la entrada es directorio.

Si el archivo se abre inmediatamente con el parámetro se bloquea hasta que el archivo se apaga.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

El nombre del archivo, como parte de la name’, supera los 100 símbolos.

CreateEntry(Síntomas, Síntomas y Bool)

Crea una entrada única dentro del archivo.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Parameters

name string

El nombre de la entrada.

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

Returns

TarEntry

Introducción a la instancia.

Examples

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

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

ArgumentNullException

path’ is null.

SecurityException

El solicitante no tiene la autorización necesaria para acceder.

ArgumentException

El path’ es vacío, contiene sólo espacios blancos, o contiene caracteres invalidos. - o - Nombre de archivo, como parte de name’, supera los 100 símbolos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

El nombre de archivo especificado path”, o ambos superen 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 tar como de la norma IEEE 1003.1-1998.

NotSupportedException

El archivo en path’ contiene una columna (:) en el medio de la línea.

DeleteEntry(TarEntry)

Elimina la primera aparición de una entrada específica de la lista de entrada.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

La entrada a eliminar de la lista de entradas.

Returns

TarArchive

El archivo con la entrada fue eliminado.

Examples

Aquí está cómo puedes eliminar todas las entradas excepto la última:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(Int)

Elimina la entrada de la lista de entrada por índice.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

El índice basado en cero de la entrada a eliminar.

Returns

TarArchive

El archivo con la entrada fue eliminado.

Examples

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

Exceptions

ArgumentOutOfRangeException

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

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 TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Si el directorio no existe, se crear.

Exceptions

ArgumentNullException

El camino es nulo

PathTooLongException

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.

SecurityException

El llamador no tiene el permiso necesario para acceder al directorio existente.

NotSupportedException

Si el directorio no existe, el camino contiene un carácter colon (:) que no forma parte de una etiqueta de disco (“C:”).

ArgumentException

Path es una línea de longitud cero, contiene sólo espacio blanco, o contienen uno o más caracteres invalidos.Puede solicitar los personajes invalidados utilizando el método System.IO.path.GetInvalidPathChars.

IOException

El directorio especificado por ruta es un archivo. - o - El nombre de red no es conocido.

de GZIP(Stream)

Extractos suministrados archivo gzip y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: el archivo gzip se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción de GZip no es buscable por la naturaleza del algoritmo de compresión.El archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

InvalidDataException

El archivo está corrupto.

de GZIP(El string)

Extractos suministrados archivo gzip y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: el archivo gzip se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromGZip(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción de GZip no es buscable por la naturaleza del algoritmo de compresión.El archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

InvalidDataException

El archivo está corrupto.

El LZ4(El string)

Extractos suministrados archivo LZ4 y compone Aspose.Zip.Tar.tarArchive de los datos extraídos.

Importante: El archivo LZ4 se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromLZ4(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción LZ4 no es buscable por la naturaleza del algoritmo de compresión. el archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el Flujo buscado bajo el hood.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El solicitante no tiene la autorización necesaria para acceder

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

EndOfStreamException

El archivo es demasiado corto.

InvalidDataException

El archivo tiene la firma equivocada.

El LZ4(Stream)

Extractos suministrados archivo LZ4 y compone Aspose.Zip.Tar.tarArchive de los datos extraídos.

Importante: El archivo LZ4 se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción LZ4 no es buscable por la naturaleza del algoritmo de compresión. el archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el Flujo buscado bajo el hood.

Exceptions

ArgumentException

No se puede leer desde source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

La fuente " tiene la firma equivocada.

de LZMA(Stream)

Extractos suministrados en el archivo LZMA y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: El archivo LZMA se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción LZMA no es buscable por la naturaleza del algoritmo de compresión. el archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

InvalidDataException

El archivo está corrupto.

de LZMA(El string)

Extractos suministrados en el archivo LZMA y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: El archivo LZMA se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromLZMA(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción LZMA no es buscable por la naturaleza del algoritmo de compresión. el archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el Flujo buscado bajo el hood.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

de LZIP(Stream)

Extractos suministrados archivo lzip y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: el archivo lzip se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción de Lzip no es buscable por la naturaleza del algoritmo de compresión. el archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

InvalidDataException

El archivo está corrupto.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

de LZIP(El string)

Extractos suministrados archivo lzip y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: el archivo lzip se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromLZip(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El flujo de extracción de Lzip no es buscable por la naturaleza del algoritmo de compresión. el archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

InvalidDataException

El archivo está corrupto.

FromXz(Stream)

Extractos suministrados en el archivo de formato xz y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: el archivo xz se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

FromXz(El string)

Extractos suministrados en el archivo de formato xz y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: el archivo xz se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromXz(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

de Z(Stream)

Extracto suministrado archivo de formato Z y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: El archivo Z se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

de Z(El string)

Extracto suministrado archivo de formato Z y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: El archivo Z se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromZ(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Remarks

El archivo Tar proporciona la facilidad para extraer registros arbitrarios, por lo que tiene que operar el flujo buscable debajo del hood.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

FromZstandard(Stream)

Extractos suministrados en el archivo Zstandard y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: El archivo estándar se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

La fuente del archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Exceptions

IOException

El flujo Zstandard es corrompido o no leible.

InvalidDataException

Los datos están corruptos.

FromZstandard(El string)

Extractos suministrados en el archivo Zstandard y compone Aspose.Zip.Tar.TarArchive de los datos extraídos.

Importante: El archivo estándar se extrae completamente dentro de este método, su contenido se mantiene internamente.

public static TarArchive FromZstandard(string path)

Parameters

path string

El camino hacia el archivo.

Returns

TarArchive

Un ejemplo de Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

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.

NotSupportedException

El archivo en path" está en un formato invalido.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

FileNotFoundException

El archivo no se encuentra.

IOException

El flujo Zstandard es corrompido o no leible.

InvalidDataException

Los datos están corruptos.

Save(Termato y Tarformato?)

Salva archivos a la corriente proporcionada.

public void Save(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Remarks

Debe ser escrito.

Exceptions

ArgumentException

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

Save(Las líneas, TarFormat?)

Salva archivo a un archivo de destino proporcionado.

public void Save(string destinationFileName, TarFormat? format = null)

Parameters

destinationFileName string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Remarks

Es posible guardar un archivo en el mismo camino que fue cargado de. sin embargo, esto no se recomienda porque este enfoque utiliza la copia a un archivo temporal.

Exceptions

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

La destinationFileName’, 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.

DirectoryNotFoundException

La destinationFileName" especificada es invalida (por ejemplo, se encuentra en un disco no mapeado).

IOException

Un error I/O ocurrió al abrir el archivo.

UnauthorizedAccessException

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

El archivo no se encuentra.

SaveGzipped(Termato y Tarformato?)

Salva archivos a la corriente con la composición gzip.

public void SaveGzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

Remarks

Debe ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Las líneas, TarFormat?)

Salva archivos al archivo por vía con la composición gzip.

public void SaveGzipped(string path, TarFormat? format = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

Título: SaveLZ4Compressed(Termato y Tarformato?)

Salva archivos a la corriente con la compresión LZ4.

public void SaveLZ4Compressed(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz4"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZ4Compressed(result);
        }
    }
}

Remarks

Debe ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Título: SaveLZ4Compressed(Las líneas, TarFormat?)

Salva archivos al archivo por vía con la composición LZ4.

public void SaveLZ4Compressed(string path, TarFormat? format = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZ4Compressed("result.tar.lz4");
    }
}

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

Salvación compresada(Termato y Tarformato?)

Salva archivo al flujo con la compresión LZMA.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

Remarks

Debe ser escrito.

Importante: el archivo de tar se compone y luego se comprime dentro de este método, su contenido se mantiene internamente.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Salvación compresada(Las líneas, TarFormat?)

Salva archivo al archivo por vía con la compresión lzma.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

Remarks

Importante: el archivo de tar se compone y luego se comprime dentro de este método, su contenido se mantiene internamente.

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Termato y Tarformato?)

Salva archivos a la corriente con la compresión lzip.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

Remarks

Debe ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Las líneas, TarFormat?)

Salva archivo al archivo por vía con la compresión lzip.

public void SaveLzipped(string path, TarFormat? format = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Arreglo, TarFormat?, XzArchiveSettings)

Salva archivos a la corriente con la composición xz.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

settings XzArchiveSettings

Set de configuración específica xz archivo: tamaño diccionario, tamaño de bloque, tipo de verificación.

Examples

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

Remarks

El flujo debe ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Título, Título, XzArchiveSettings)

Salva archivo al camino por camino con la composición xz.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

settings XzArchiveSettings

Set de configuración específica xz archivo: tamaño diccionario, tamaño de bloque, tipo de verificación.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

SalvaciónCompreso(Termato y Tarformato?)

Salva archivos a la corriente con la composición Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

Remarks

Debe ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SalvaciónCompreso(Las líneas, TarFormat?)

Salva archivos al camino por camino con la compresión Z.

public void SaveZCompressed(string path, TarFormat? format = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Termato y Tarformato?)

Salva archivos a la corriente con la composición Zstandard.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parameters

output Stream

El flujo de destino.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

Remarks

Debe ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Las líneas, TarFormat?)

Salva archivos al archivo por camino con la compresión Zstandard.

public void SaveZstandard(string path, TarFormat? format = null)

Parameters

path string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

format TarFormat ?

Define el formato de los header tar. El valor nulo será tratado como USTar cuando sea posible.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}

Exceptions

UnauthorizedAccessException

El llamador no tiene el permiso requerido. -o- path’ especificado un archivo o directorio sólo leído.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

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.

DirectoryNotFoundException

El path" especificado es invalido (por ejemplo, se encuentra en un disco no mapeado).

NotSupportedException

path’ is in an invalid format.

 Español