Class TarArchive

Class TarArchive

Nom dels espais: Aspose.Zip.Tar Assemblea: Aspose.Zip.dll (25.5.0)

Aquesta classe representa un arxiu de tar. Utilitzeu-lo per compondre, extreure o actualitzar archives.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Membres heretats

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

Constructors

TarArchive()

Inicia una nova instància de la classe Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

L’exemple següent mostra com comprimir un fitxer.

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

TarArchive(Stream)

Inicialitza una nova instància de la classe Aspose.Zip.Arxiu i componeix una llista d’entrada que es pot extreure de l’arxiu.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

La font de l’arxiu. ha de ser buscable.

Examples

L’exemple següent mostra com extreure totes les entrades a un directori.

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

Remarks

Aquest constructor no desembarca cap entrada. Veure Aspose.Zip.Tar.TarEntry.Open mètode per desembarcament.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Tàrrega)

Inicialitza una nova instància de la classe Aspose.Zip.Tar.Arxiu i componeix una llista d’entrada que es pot extreure de l’arxius.

public TarArchive(string path)

Parameters

path string

El camí cap a l’arxiu.

Examples

L’exemple següent mostra com extreure totes les entrades a un directori.

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

Remarks

Aquest constructor no desembarca cap entrada. Veure Aspose.Zip.Tar.TarEntry.Open mètode per desembarcament.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

FileNotFoundException

El fitxer no es troba.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

El fitxer ja està obert.

Properties

Entries

Obté entrades del tipus Aspose.Zip.Tar.TarEntry que constitueix l’arxiu.

public ReadOnlyCollection<tarentry> Entries { get; }

Valor de la propietat

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(DireccióInfo, Bool)

Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.

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

Parameters

directory DirectoryInfo

Direcció per a la compressi.

includeRootDirectory bool

Indica si incloure o no la pròpia direcció de les arrels.

Returns

TarArchive

L’arxiu amb entrades compostes.

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(Tàrrega, Bool)

Afegeix a l’arxiu tots els arxius i directoris recursivament en el directori donat.

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

Parameters

sourceDirectory string

Direcció per a la compressi.

includeRootDirectory bool

Indica si incloure o no la pròpia direcció de les arrels.

Returns

TarArchive

L’arxiu amb entrades compostes.

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 convocador no té el permís requerit per accedir a sourceDirectory'.

ArgumentException

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

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters.

CreateEntry(Arxiu, Arxiu, FileSystemInfo)

Crear una entrada única dins de l’arxiu.

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

Parameters

name string

El nom de l’entrada.

source Stream

El flux d’entrada per a l’entrada.

fileInfo FileSystemInfo

Els metadats del fitxer o de la carpeta per a ser comprès.

Returns

TarEntry

Introducció a la instància.

Examples

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

Remarks

El nom d’entrada s’estableix únicament dins del paràmetre.El nom de fitxer proporcionat en el paràmetre no afecta el nom d’entrada.

pot referir-se a System.IO.DirectoryInfo si la entrada és directori.

Exceptions

PathTooLongException

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

ArgumentException

El nom de fitxer, com a part de la name’, supera els 100 símbols.

CreateEntry(Arxiu, FileInfo, Bool)

Crear una entrada única dins de l’arxiu.

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

Parameters

name string

El nom de l’entrada.

fileInfo FileInfo

Els metadats del fitxer o de la carpeta per a ser comprès.

openImmediately bool

s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.

Returns

TarEntry

Introducció a la instància.

Examples

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

Remarks

El nom d’entrada s’estableix únicament dins del paràmetre.El nom de fitxer proporcionat en el paràmetre no afecta el nom d’entrada.

pot referir-se a System.IO.DirectoryInfo si la entrada és directori.

Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.

Exceptions

PathTooLongException

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

ArgumentException

El nom de fitxer, com a part de la name’, supera els 100 símbols.

CreateEntry(Tècnic, Tècnic, Tècnic)

Crear una entrada única dins de l’arxiu.

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

Parameters

name string

El nom de l’entrada.

path string

El camí per a arxiu per a ser comprès.

openImmediately bool

s cert, si obre el fitxer immediatament, d’altra banda obre el fitxer en l’arxiu d’emmagatzematge.

Returns

TarEntry

Introducció a la instància.

Examples

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

Remarks

El nom d’entrada s’estableix únicament dins del paràmetre.El nom de fitxer proporcionat en el paràmetre no afecta el nom d’entrada.

Si el fitxer s’obre immediatament amb el paràmetre es bloqueja fins que l’arxiu s’elimina.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

El path’ és buit, només conté espais blancs, o conté caràcters invalidats. - o - Nom de fitxer, com a part del name’, supera els 100 símbols.

UnauthorizedAccessException

L’accés al fitxer path” es nega.

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxers han de ser menys de 260 caràcters. - o - name’ és massa llarg per a tar que de la norma IEEE 1003.1-1998.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

DeleteEntry(TarEntry)

Elimina la primera aparició d’una entrada específica de la llista d’entrada.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

L’entrada per eliminar de la llista d’entrada.

Returns

TarArchive

L’arxiu amb la entrada es va eliminar.

Examples

A continuació podeu eliminar totes les entrades excepte les últimes:

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

DeleteEntry(Int)

Elimina l’entrada de la llista d’entrada per index.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

L’índex basat en zero de l’entrada a eliminar.

Returns

TarArchive

L’arxiu amb la entrada es va eliminar.

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()

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

public void Dispose()

Dispose(La botiga)

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

S’han de disposar de recursos gestionats.

ExtractToDirectory(Tàrrega)

Extrata tots els arxius de l’arxiu a la direcció proporcionada.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

El camí a la direcció per col·locar els arxius extraïts.

Examples

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

Remarks

Si la direcció no existeix, es crear.

Exceptions

ArgumentNullException

El camí és zero

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.

SecurityException

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

NotSupportedException

Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“C:”).

ArgumentException

Path és una sèrie de longitud zero, només conté espai blanc, o inclou un o més caràcters inhabilitats. es pot sol·licitar per a caràcters inhalats utilitzant el mètode System.IO.Path.GetInvalidPithChars. - o - el camí està prefixat amb o contingui només un carànter de còlon (:).

IOException

El directori especificat per ruta és un fitxer. - o - El nom de la xarxa no és conegut.

El Zip(Stream)

Extracte subministrat a l’arxiu gzip i componeix Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: l’arxiu gzip s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció de GZip no és buscable per la naturalesa de l’algoritme de compressi.L’arxiu Tar proporciona la facilitat d’extreure registres arbitràriament, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

InvalidDataException

L’arxiu està corromput.

El Zip(Tàrrega)

Extracte subministrat a l’arxiu gzip i componeix Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: l’arxiu gzip s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromGZip(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció de GZip no és buscable per la naturalesa de l’algoritme de compressi.L’arxiu Tar proporciona la facilitat d’extreure registres arbitràriament, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

InvalidDataException

L’arxiu està corromput.

de la LZ4(Tàrrega)

Els extractes proporcionen l’arxiu LZ4 i componeixen Aspose.Zip.Tar.tarArxive de les dades extraïdes.

Important: L’arxiu LZ4 s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromLZ4(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció LZ4 no és buscable per la naturalesa de l’algoritme de compressió. Arxiu Tar proporciona la facilitat per a extreure registres arbitràriament, de manera que ha de operar el fluix de cerca sota la cova.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís requerit per accedir

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

EndOfStreamException

El fitxer és massa curt.

InvalidDataException

El document té la signatura equivocada.

de la LZ4(Stream)

Els extractes proporcionen l’arxiu LZ4 i componeixen Aspose.Zip.Tar.tarArxive de les dades extraïdes.

Important: L’arxiu LZ4 s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció LZ4 no és buscable per la naturalesa de l’algoritme de compressió. Arxiu Tar proporciona la facilitat per a extreure registres arbitràriament, de manera que ha de operar el fluix de cerca sota la cova.

Exceptions

ArgumentException

No es pot llegir des de source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

La font " té la signatura equivocada.

de la LZMA(Stream)

Els extractes proporcionen l’arxiu LZMA i componen Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: L’arxiu LZMA s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció LZMA no és buscable per la naturalesa de l’algoritme de compressió. l’arxiu Tar proporciona la facilitat d’extracció d’un registre arbitràri, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

InvalidDataException

L’arxiu està corromput.

de la LZMA(Tàrrega)

Els extractes proporcionen l’arxiu LZMA i componen Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: L’arxiu LZMA s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromLZMA(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció LZMA no és buscable per la naturalesa de l’algoritme de compressió. Arxiu Tar proporciona la facilitat per a extreure registres arbitràriament, de manera que ha de operar el fluix de cerca sota la cova.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

de LZIP(Stream)

Extracte subministrat lzip arxiu i componeix Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: lzip arxiu s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció Lzip no és buscable per la naturalesa de l’algoritme de compressió. l’arxiu Tar proporciona la facilitat d’extracció d’un registre arbitràri, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

InvalidDataException

L’arxiu està corromput.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

de LZIP(Tàrrega)

Extracte subministrat lzip arxiu i componeix Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: lzip arxiu s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromLZip(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

El flux d’extracció Lzip no és buscable per la naturalesa de l’algoritme de compressió. l’arxiu Tar proporciona la facilitat d’extracció d’un registre arbitràri, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

InvalidDataException

L’arxiu està corromput.

FromXz(Stream)

Els extractes proporcionen l’arxiu de format xz i componeixen Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: l’arxiu xz s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

L’arxiu Tar proporciona la facilitat d’extreure registres arbitràriament, de manera que ha d’operar el flux buscable sota la cova.

FromXz(Tàrrega)

Els extractes proporcionen l’arxiu de format xz i componeixen Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: l’arxiu xz s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromXz(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

L’arxiu Tar proporciona la facilitat d’extreure registres arbitràriament, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

de Z(Stream)

Els extractes proporcionen l’arxiu de format Z i componeixen Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: L’arxiu Z s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

L’arxiu Tar proporciona la facilitat d’extreure registres arbitràriament, de manera que ha d’operar el flux buscable sota la cova.

de Z(Tàrrega)

Els extractes proporcionen l’arxiu de format Z i componeixen Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: L’arxiu Z s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromZ(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Remarks

L’arxiu Tar proporciona la facilitat d’extreure registres arbitràriament, de manera que ha d’operar el flux buscable sota la cova.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

FromZstandard(Stream)

Extracte subministrat a l’arxiu Zstandard i componeix Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: L’arxiu estàndard s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

La font de l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Exceptions

IOException

El corrent estàndard és corromput o no llegible.

InvalidDataException

Les dades estan corrompudes.

FromZstandard(Tàrrega)

Extracte subministrat a l’arxiu Zstandard i componeix Aspose.Zip.Tar.TarArchive de les dades extraïdes.

Important: L’arxiu estàndard s’extreu completament dins d’aquest mètode, el seu contingut es conserva internament.

public static TarArchive FromZstandard(string path)

Parameters

path string

El camí cap a l’arxiu.

Returns

TarArchive

Un exemple de Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer en path" està en un format invalid.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

FileNotFoundException

El fitxer no es troba.

IOException

El corrent estàndard és corromput o no llegible.

InvalidDataException

Les dades estan corrompudes.

Save(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent proporcionat.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

Examples

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

Remarks

Ha de ser escriïble.

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(Tàrrega i Tàrrega?)

Salva l’arxiu a un arxiu de destinació proporcionat.

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

Parameters

destinationFileName string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

Examples

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

Remarks

s possible guardar un arxiu al mateix camí que es va carregar des. No obstant això, això no es recomana perquè aquest enfocament utilitza la còpia a un arxiu 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

El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La destinació especificada FileName’ és invalidada (per exemple, es troba en un disc no mapeat).

IOException

Un error I/O es va produir durant l’obertura del fitxer.

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 fitxer no es troba.

SaveGzipped(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent amb la compressió gzip.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Ha de ser escriïble.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Tàrrega i Tàrrega?)

Salva l’arxiu al fitxer per camí amb la compressió gzip.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

4 Compressió(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent amb la compressió LZ4.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Ha de ser escriïble.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

4 Compressió(Tàrrega i Tàrrega?)

Salva l’arxiu al fitxer per camí amb la compressió LZ4.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

Compressió de salvatge(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent amb la compressió LZMA.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Ha de ser escriïble.

Important: l’arxiu tar es componeix i després es comprimeix dins d’aquest mètode, el seu contingut es conserva internament.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Compressió de salvatge(Tàrrega i Tàrrega?)

Salva l’arxiu al fitxer per camí amb la compressió lzma.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Important: l’arxiu tar es componeix i després es comprimeix dins d’aquest mètode, el seu contingut es conserva internament.

Exceptions

UnauthorizedAccessException

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent amb la compressió lzip.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Ha de ser escriïble.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Tàrrega i Tàrrega?)

Salva l’arxiu al fitxer per camí amb la compressió lzip.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Arxiu, TarFormat?, XzArchiveSettings)

Salva l’arxiu al corrent amb xz compressi.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

settings XzArchiveSettings

Set de configuració específic xz arxiu: mida del diccionari, mida del bloc, tipus de comprovaci.

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 flux ha de ser escrit.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Llistat, TarFormat?, XzArchiveSettings)

Salva l’arxiu al camí per camí amb xz compressi.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

settings XzArchiveSettings

Set de configuració específic xz arxiu: mida del diccionari, mida del bloc, tipus de comprovaci.

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

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

Compressió(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent amb la compressió Z.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Ha de ser escriïble.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Compressió(Tàrrega i Tàrrega?)

Salva l’arxiu al camí per camí amb la compressió Z.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Tàrrega o Tàrrega?)

Salva l’arxiu al corrent amb la compressió Zstandard.

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

Parameters

output Stream

El flux de destinaci.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

Ha de ser escriïble.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Tàrrega i Tàrrega?)

Salva l’arxiu al fitxer per camí amb la compressió Zstandard.

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

Parameters

path string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

format TarFormat ?

Defineix el format de titulació tar. El valor zero es tractarà com USTar quan sigui possible.

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

L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.

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

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

DirectoryNotFoundException

La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).

NotSupportedException

path’ is in an invalid format.

 Català