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
Implements
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
sourceStream’ is not seekable.
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
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
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
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
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
sourceDirectory’ is null.
El convocador no té el permís requerit per accedir a sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
path’ is null.
El client no té el permís d’accés requerit.
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.
L’accés al fitxer path” es nega.
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.
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
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 > 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
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
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
El camí és zero
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.
El sol·licitant no té l’autorització necessària per accedir a la direcció existent.
Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“C:”).
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 (:).
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
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
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
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
path’ is null.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer no es troba.
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
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
path’ is null.
El client no té el permís requerit per accedir
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer no es troba.
El fitxer és massa curt.
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
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
No es pot llegir des de source’
source’ is null.
source’ is too short.
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
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
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
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
path’ is null.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
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
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
L’arxiu està corromput.
source’ is not seekable.
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
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
path’ is null.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer no es troba.
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
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
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
path’ is null.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
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
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
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
path’ is null.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
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
Un exemple de Aspose.Zip.Tar.TarArchive
Exceptions
El corrent estàndard és corromput o no llegible.
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
Un exemple de Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
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.
El fitxer en path" està en un format invalid.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer no es troba.
El corrent estàndard és corromput o no llegible.
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
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
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
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.
La destinació especificada FileName’ és invalidada (per exemple, es troba en un disc no mapeat).
Un error I/O es va produir durant l’obertura del fitxer.
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.
destinationFileName’ is in an invalid format.
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
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
output’ is null.
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
L’anunciador no té el permís requerit. -o- path’ especificat un fitxer o directori de lectura únic.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
La ruta " especificada és invalidada (per exemple, es troba en un disc no mapat).
path’ is in an invalid format.