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
Implementa
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
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
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
El path
está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo path
está denegado.
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.
El archivo en path
contiene dos puntos (:) en medio de la cadena.
El archivo no se encuentra.
La ruta especificada no es válida, como estar en una unidad no asignada.
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>
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
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
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
sourceDirectory
es nulo.
El llamador no tiene el permiso requerido para acceder a sourceDirectory
.
sourceDirectory
contiene caracteres no válidos como “, <, > o |.
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
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
name
es demasiado largo para tar según el estándar IEEE 1003.1-1998.
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
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
name
es demasiado largo para tar según el estándar IEEE 1003.1-1998.
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
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
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
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.
El acceso al archivo path
está denegado.
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.
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
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 > 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
El archivo con la entrada eliminada.
Ejemplos
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Excepciones
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
path es nulo
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.
El llamador no tiene el permiso requerido para acceder al directorio existente.
Si el directorio no existe, la ruta contiene un carácter de dos puntos (:) que no es parte de una etiqueta de unidad (“C:").
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 (:).
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
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
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
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
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
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
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
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
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
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
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
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
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
Una instancia de Aspose.Zip.Tar.TarArchive
Excepciones
El flujo Zstandard está dañado o no es legible.
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
Una instancia de Aspose.Zip.Tar.TarArchive
Excepciones
El flujo Zstandard está dañado o no es legible.
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
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
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.
destinationFileName
es nulo.
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.
El destinationFileName
especificado no es válido, (por ejemplo, está en una unidad no asignada).
Ocurrió un error de E/S al abrir el archivo.
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.
destinationFileName
está en un formato no válido.
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
output
es nulo.
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.
Excepciones
output
es nulo.
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
output
es nulo.
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
output
es nulo.
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
output
es nulo.
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
output
es nulo.
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");
}
}