Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Esta clase representa un archivo de archivo tar. Úselo para componer, extraer o actualizar archivos tar.

public class TarArchive : IArchive, IDisposable

Herencia

objectTarArchive

Implementa

IArchive, IDisposable

Miembros heredados

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

Constructores

TarArchive()

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

public TarArchive()

Ejemplos

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 la lista de entradas que se pueden extraer del archivo.

public TarArchive(Stream sourceStream)

Parámetros

sourceStream Stream

La fuente del archivo. Debe ser buscable.

Ejemplos

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");
}

Observaciones

Este constructor no desempaqueta ninguna entrada. Consulte el método Aspose.Zip.Tar.TarEntry.Open para desempaquetar.

Excepciones

InvalidDataException

sourceStream no es buscable.

TarArchive(string)

Inicializa una nueva instancia de la clase Aspose.Zip.Tar.TarArchive y compone la lista de entradas que se pueden extraer del archivo.

public TarArchive(string path)

Parámetros

path string

La ruta al archivo del archivo.

Ejemplos

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

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

Observaciones

Este constructor no desempaqueta ninguna entrada. Consulte el método Aspose.Zip.Tar.TarEntry.Open para desempaquetar.

Excepciones

ArgumentNullException

path es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

El path está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

El acceso al archivo path está denegado.

PathTooLongException

El path, nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres y los nombres de archivo deben ser menores de 260 caracteres.

NotSupportedException

El archivo en path contiene dos puntos (:) en medio de la cadena.

FileNotFoundException

El archivo no se encuentra.

DirectoryNotFoundException

La ruta especificada no es válida, como estar en una unidad no asignada.

IOException

El archivo ya está abierto.

Propiedades

Entries

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

public ReadOnlyCollection<tarentry> Entries { get; }

Valor de la propiedad

ReadOnlyCollection<TarEntry&gt;

Métodos

CreateEntries(DirectoryInfo, bool)

Agrega al archivo todos los archivos y directorios recursivamente en el directorio dado.

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

Parámetros

directory DirectoryInfo

Directorio a comprimir.

includeRootDirectory bool

Indica si incluir el directorio raíz en sí o no.

Retorna

TarArchive

El archivo con las entradas compuestas.

Ejemplos

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(string, bool)

Agrega al archivo todos los archivos y directorios recursivamente en el directorio dado.

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

Parámetros

sourceDirectory string

Directorio a comprimir.

includeRootDirectory bool

Indica si incluir el directorio raíz en sí o no.

Retorna

TarArchive

El archivo con las entradas compuestas.

Ejemplos

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

Excepciones

ArgumentNullException

sourceDirectory es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder a sourceDirectory.

ArgumentException

sourceDirectory contiene caracteres no válidos como “, <, > o |.

PathTooLongException

La ruta especificada, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres y los nombres de archivo deben ser menores de 260 caracteres. La ruta especificada, el nombre del archivo o ambos son demasiado largos.

CreateEntry(string, Stream, FileSystemInfo)

Crea una entrada única dentro del archivo.

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

Parámetros

name string

El nombre de la entrada.

source Stream

El flujo de entrada para la entrada.

fileInfo FileSystemInfo

Los metadatos del archivo o carpeta a comprimir.

Retorna

TarEntry

Instancia de entrada Tar.

Ejemplos

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

Observaciones

El nombre de la entrada se establece únicamente dentro del parámetro name. El nombre del archivo proporcionado en el parámetro fileInfo no afecta el nombre de la entrada.

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

Excepciones

PathTooLongException

name es demasiado largo para tar según el estándar IEEE 1003.1-1998.

ArgumentException

El nombre del archivo, como parte de name, excede los 100 símbolos.

CreateEntry(string, FileInfo, bool)

Crea una entrada única dentro del archivo.

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

Parámetros

name string

El nombre de la entrada.

fileInfo FileInfo

Los metadatos del archivo o carpeta a comprimir.

openImmediately bool

Verdadero si se abre el archivo inmediatamente, de lo contrario, se abre el archivo al guardar el archivo.

Retorna

TarEntry

Instancia de entrada Tar.

Ejemplos

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

Observaciones

El nombre de la entrada se establece únicamente dentro del parámetro name. El nombre del archivo proporcionado en el parámetro fileInfo no afecta el nombre de la entrada.

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

Si el archivo se abre inmediatamente con el parámetro openImmediately, queda bloqueado hasta que se disponga del archivo.

Excepciones

PathTooLongException

name es demasiado largo para tar según el estándar IEEE 1003.1-1998.

ArgumentException

El nombre del archivo, como parte de name, excede los 100 símbolos.

CreateEntry(string, string, bool)

Crea una entrada única dentro del archivo.

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

Parámetros

name string

El nombre de la entrada.

path string

Ruta al archivo a comprimir.

openImmediately bool

Verdadero si se abre el archivo inmediatamente, de lo contrario, se abre el archivo al guardar el archivo.

Retorna

TarEntry

Instancia de entrada Tar.

Ejemplos

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

Observaciones

El nombre de la entrada se establece únicamente dentro del parámetro name. El nombre del archivo proporcionado en el parámetro path no afecta el nombre de la entrada.

Si el archivo se abre inmediatamente con el parámetro openImmediately, queda bloqueado hasta que se disponga del archivo.

Excepciones

ArgumentNullException

path es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

El path está vacío, contiene solo espacios en blanco o contiene caracteres no válidos. - o - El nombre del archivo, como parte de name, excede los 100 símbolos.

UnauthorizedAccessException

El acceso al archivo path está denegado.

PathTooLongException

El path especificado, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres y los nombres de archivo deben ser menores de 260 caracteres. - o - name es demasiado largo para tar según el estándar IEEE 1003.1-1998.

NotSupportedException

El archivo en path contiene dos puntos (:) en medio de la cadena.

DeleteEntry(TarEntry)

Elimina la primera ocurrencia de una entrada específica de la lista de entradas.

public TarArchive DeleteEntry(TarEntry entry)

Parámetros

entry TarEntry

La entrada a eliminar de la lista de entradas.

Retorna

TarArchive

El archivo con la entrada eliminada.

Ejemplos

Aquí se muestra cómo puede 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 entradas por índice.

public TarArchive DeleteEntry(int entryIndex)

Parámetros

entryIndex int

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

Retorna

TarArchive

El archivo con la entrada eliminada.

Ejemplos

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

Excepciones

ArgumentOutOfRangeException

entryIndex es menor que 0.-o- entryIndex es igual o mayor que Entries count.

Dispose()

Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o reinicio de recursos no administrados.

public void Dispose()

Dispose(bool)

Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o reinicio de recursos no administrados.

protected virtual void Dispose(bool disposing)

Parámetros

disposing bool

Si los recursos administrados deben ser eliminados.

ExtractToDirectory(string)

Extrae todos los archivos en el archivo al directorio proporcionado.

public void ExtractToDirectory(string destinationDirectory)

Parámetros

destinationDirectory string

La ruta al directorio donde se colocarán los archivos extraídos.

Ejemplos

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

Observaciones

Si el directorio no existe, se creará.

Excepciones

ArgumentNullException

path es nulo

PathTooLongException

El path, nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres y los nombres de archivo deben ser menores de 260 caracteres.

SecurityException

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

NotSupportedException

Si el directorio no existe, la ruta contiene un carácter de dos puntos (:) que no es parte de una etiqueta de unidad (“C:").

ArgumentException

path es una cadena de longitud cero, contiene solo espacio en blanco o contiene uno o más caracteres no válidos. Puede consultar los caracteres no válidos utilizando el método System.IO.Path.GetInvalidPathChars. -o- path está precedido por, o contiene, solo un carácter de dos puntos (:).

IOException

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

FromGZip(Stream)

Extrae el archivo gzip proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

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

public static TarArchive FromGZip(Stream source)

Parámetros

source Stream

La fuente del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El flujo de extracción de GZip no es buscable por la naturaleza del algoritmo de compresión. El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

Excepciones

InvalidDataException

El archivo está dañado.

FromGZip(string)

Extrae el archivo gzip proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

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

public static TarArchive FromGZip(string path)

Parámetros

path string

La ruta al archivo del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El flujo de extracción de GZip no es buscable por la naturaleza del algoritmo de compresión. El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

Excepciones

InvalidDataException

El archivo está dañado.

FromLZMA(Stream)

Extrae el archivo LZMA proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

Importante: el archivo LZMA se extrae completamente dentro de este método, su contenido se mantiene internamente. Tenga cuidado con el consumo de memoria.

public static TarArchive FromLZMA(Stream source)

Parámetros

source Stream

La fuente del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El flujo de extracción de LZMA no es buscable por la naturaleza del algoritmo de compresión. El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromLZMA(string)

Extrae el archivo LZMA proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

Importante: el archivo LZMA se extrae completamente dentro de este método, su contenido se mantiene internamente. Tenga cuidado con el consumo de memoria.

public static TarArchive FromLZMA(string path)

Parámetros

path string

La ruta al archivo del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El flujo de extracción de LZMA no es buscable por la naturaleza del algoritmo de compresión. El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromLZip(Stream)

Extrae el archivo lzip proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

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

public static TarArchive FromLZip(Stream source)

Parámetros

source Stream

La fuente del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El flujo de extracción de lzip no es buscable por la naturaleza del algoritmo de compresión. El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromLZip(string)

Extrae el archivo lzip proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

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

public static TarArchive FromLZip(string path)

Parámetros

path string

La ruta al archivo del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El flujo de extracción de lzip no es buscable por la naturaleza del algoritmo de compresión. El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromXz(Stream)

Extrae el archivo en formato xz proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

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

public static TarArchive FromXz(Stream source)

Parámetros

source Stream

La fuente del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromXz(string)

Extrae el archivo en formato xz proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

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

public static TarArchive FromXz(string path)

Parámetros

path string

La ruta al archivo del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromZ(Stream)

Extrae el archivo en formato Z proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

Importante: el archivo Z se extrae completamente dentro de este método, su contenido se mantiene internamente. Tenga cuidado con el consumo de memoria.

public static TarArchive FromZ(Stream source)

Parámetros

source Stream

La fuente del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromZ(string)

Extrae el archivo en formato Z proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

Importante: el archivo Z se extrae completamente dentro de este método, su contenido se mantiene internamente. Tenga cuidado con el consumo de memoria.

public static TarArchive FromZ(string path)

Parámetros

path string

La ruta al archivo del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Observaciones

El archivo Tar proporciona la facilidad de extraer registros arbitrarios, por lo que debe operar un flujo buscable bajo el capó.

FromZstandard(Stream)

Extrae el archivo en formato Zstandard proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

Importante: el archivo Zstandard se extrae completamente dentro de este método, su contenido se mantiene internamente. Tenga cuidado con el consumo de memoria.

public static TarArchive FromZstandard(Stream source)

Parámetros

source Stream

La fuente del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Excepciones

IOException

El flujo Zstandard está dañado o no es legible.

InvalidDataException

Los datos están dañados.

FromZstandard(string)

Extrae el archivo en formato Zstandard proporcionado y compone Aspose.Zip.Tar.TarArchive a partir de los datos extraídos.

Importante: el archivo Zstandard se extrae completamente dentro de este método, su contenido se mantiene internamente. Tenga cuidado con el consumo de memoria.

public static TarArchive FromZstandard(string path)

Parámetros

path string

La ruta al archivo del archivo.

Retorna

TarArchive

Una instancia de Aspose.Zip.Tar.TarArchive

Excepciones

IOException

El flujo Zstandard está dañado o no es legible.

InvalidDataException

Los datos están dañados.

Save(Stream, TarFormat?)

Guarda el archivo en el flujo proporcionado.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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

Observaciones

output debe ser escribible.

Excepciones

ArgumentException

output no es escribible. - o - output es el mismo flujo del que extraemos. - O - No es posible guardar el archivo en format debido a restricciones de formato.

Save(string, TarFormat?)

Guarda el archivo en el archivo de destino proporcionado.

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

Parámetros

destinationFileName string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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

Observaciones

Es posible guardar un archivo en la misma ruta de la que se cargó. Sin embargo, esto no se recomienda porque este enfoque utiliza la copia a un archivo temporal.

Excepciones

ArgumentException

destinationFileName es una cadena de longitud cero, contiene solo espacio en blanco o contiene uno o más caracteres no válidos según lo definido por System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName es nulo.

PathTooLongException

El destinationFileName, nombre de archivo o ambos exceden la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben ser menores de 248 caracteres y los nombres de archivo deben ser menores de 260 caracteres.

DirectoryNotFoundException

El destinationFileName especificado no es válido, (por ejemplo, está en una unidad no asignada).

IOException

Ocurrió un error de E/S al abrir el archivo.

UnauthorizedAccessException

destinationFileName especifica un archivo que es de solo lectura y el acceso no es de lectura.-o- la ruta especificada es un directorio.-o- El llamador no tiene el permiso requerido.

NotSupportedException

destinationFileName está en un formato no válido.

FileNotFoundException

El archivo no se encuentra.

SaveGzipped(Stream, TarFormat?)

Guarda el archivo en el flujo con compresión gzip.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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);
        }
    }
}

Observaciones

output debe ser escribible.

Excepciones

ArgumentNullException

output es nulo.

ArgumentException

output no es escribible.

SaveGzipped(string, TarFormat?)

Guarda el archivo en el archivo por ruta con compresión gzip.

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

Parámetros

path string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

Guarda el archivo en el flujo con compresión LZMA.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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);
        }
    }
}

Observaciones

output debe ser escribible.

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

Excepciones

ArgumentNullException

output es nulo.

ArgumentException

output no es escribible.

SaveLZMACompressed(string, TarFormat?)

Guarda el archivo en el archivo por ruta con compresión lzma.

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

Parámetros

path string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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");
    }
}

Observaciones

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

SaveLzipped(Stream, TarFormat?)

Guarda el archivo en el flujo con compresión lzip.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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);
        }
    }
}

Observaciones

output debe ser escribible.

Excepciones

ArgumentNullException

output es nulo.

ArgumentException

output no es escribible.

SaveLzipped(string, TarFormat?)

Guarda el archivo en el archivo por ruta con compresión lzip.

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

Parámetros

path string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Guarda el archivo en el flujo con compresión xz.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

settings XzArchiveSettings

Conjunto de configuraciones del archivo xz particular: tamaño del diccionario, tamaño del bloque, tipo de verificación.

Ejemplos

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);
        }
    }
}

Observaciones

output El flujo debe ser escribible.

Excepciones

ArgumentNullException

output es nulo.

ArgumentException

output no es escribible.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Guarda el archivo en la ruta por ruta con compresión xz.

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

Parámetros

path string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

settings XzArchiveSettings

Conjunto de configuraciones del archivo xz particular: tamaño del diccionario, tamaño del bloque, tipo de verificación.

Ejemplos

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");
    }
}

SaveZCompressed(Stream, TarFormat?)

Guarda el archivo en el flujo con compresión Z.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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);
        }
    }
}

Observaciones

output debe ser escribible.

Excepciones

ArgumentNullException

output es nulo.

ArgumentException

output no es escribible.

SaveZCompressed(string, TarFormat?)

Guarda el archivo en la ruta por ruta con compresión Z.

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

Parámetros

path string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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");
    }
}

SaveZstandard(Stream, TarFormat?)

Guarda el archivo en el flujo con compresión Zstandard.

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

Parámetros

output Stream

Flujo de destino.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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);
        }
    }
}

Observaciones

output debe ser escribible.

Excepciones

ArgumentNullException

output es nulo.

ArgumentException

output no es escribible.

SaveZstandard(string, TarFormat?)

Guarda el archivo en el archivo por ruta con compresión Zstandard.

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

Parámetros

path string

La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.

format TarFormat?

Define el formato del encabezado tar. El valor nulo se tratará como USTar cuando sea posible.

Ejemplos

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");
    }
}
 Español