Class TarArchive
Numele spaţiului: Aspose.Zip.Tar Asamblare: Aspose.Zip.dll (25.5.0)
Această clasă reprezintă un fișier de arhivă tar. Utilizați-l pentru a compune, extrage sau actualizează arhivele Tar.
public class TarArchive : IArchive, IDisposable
Inheritance
Implements
Membrii moștenitori
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
TarArchive()
Inițializează o nouă instanță a clasei Aspose.Zip.Tar.TarArchive.
public TarArchive()
Examples
Următorul exemplu arată cum să compresezi un fișier.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
Inițializează o nouă instanță a clasei Aspose.Zip.Archive și compune o listă de intrări care poate fi extras din arhivă.
public TarArchive(Stream sourceStream)
Parameters
sourceStream
Stream
Sursă de arhivă. trebuie să fie căutată.
Examples
Următorul exemplu arată cum să extrageți toate intrările într-un director.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Acest constructor nu dezambalează nici o intrare. Vezi Aspose.Zip.Tar.TarEntry.Metoda deschisă pentru dezambalare.
Exceptions
sourceStream’ is not seekable.
sourceStream’ is null.
TarArchive(Strângere)
Inițializează o nouă instanță a clasei Aspose.Zip.TarArchive și compune o listă de intrări care poate fi extinsă din arhivă.
public TarArchive(string path)
Parameters
path
string
Calea către arhivă.
Examples
Următorul exemplu arată cum să extrageți toate intrările într-un director.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Acest constructor nu dezambalează nici o intrare. Vezi Aspose.Zip.Tar.TarEntry.Metoda deschisă pentru dezambalare.
Exceptions
path’ is null.
Solicitantul nu are permisiunea necesară de acces.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
Dosarul nu a fost găsit.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul este deja deschis.
Properties
Entries
Obține intrări de tip Aspose.Zip.Tar.TarEntry care constituie arhiva.
public ReadOnlyCollection<tarentry> Entries { get; }
Valoarea proprietății
ReadOnlyCollection < TarEntry >
Methods
CreateEntries(Cuvânt cheie, bool)
Adăugați în arhiv toate fișierele și directorii în mod recurent în directorul dat.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
Parameters
directory
DirectoryInfo
Directoare pentru compresă.
includeRootDirectory
bool
Indică dacă să includă directorul de rădăcină în sine sau nu.
Returns
Arhiva cu intrări compuse.
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(Cuvânt cheie, bool)
Adăugați în arhiv toate fișierele și directorii în mod recurent în directorul dat.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
Parameters
sourceDirectory
string
Directoare pentru compresă.
includeRootDirectory
bool
Indică dacă să includă directorul de rădăcină în sine sau nu.
Returns
Arhiva cu intrări compuse.
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.
Solicitantul nu are permisiunea necesară pentru a accesa sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere. Calea specificată, numele fișierului sau ambele sunt prea lungi.
CreateEntry(Strângere, Stream, FileSystemInfo)
Creați o singură intrare în arhivă.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
Parameters
name
string
Numele intrării.
source
Stream
Rata de intrare pentru intrare.
fileInfo
FileSystemInfo
Metadata fișierului sau a folderului trebuie să fie compresă.
Returns
Instanta de intrare.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
Remarks
Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.
se poate face referire la System.IO.DirectoryInfo dacă intrarea este directorie.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Numele fișierului, ca parte a name’, depășește 100 de simboluri.
CreateEntry(String, FileInfo și Bool)
Creați o singură intrare în arhivă.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
Parameters
name
string
Numele intrării.
fileInfo
FileInfo
Metadata fișierului sau a folderului trebuie să fie compresă.
openImmediately
bool
Adevărat, dacă deschideți imediat fișierul, în caz contrar deschideți fișierul pe stocarea arhivelor.
Returns
Instanta de intrare.
Examples
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
Remarks
Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.
se poate face referire la System.IO.DirectoryInfo dacă intrarea este directorie.
Dacă fișierul este deschis imediat cu parametru, acesta este blocat până când arhiva este eliminată.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Numele fișierului, ca parte a name’, depășește 100 de simboluri.
CreateEntry(String, String și Bool)
Creați o singură intrare în arhivă.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
Parameters
name
string
Numele intrării.
path
string
Calea pentru a fi compresat.
openImmediately
bool
Adevărat, dacă deschideți imediat fișierul, în caz contrar deschideți fișierul pe stocarea arhivelor.
Returns
Instanta de intrare.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
Remarks
Numele de intrare este setat numai în parametru. numele de fișier furnizat în parametru nu afectează numele de intrare.
Dacă fișierul este deschis imediat cu parametru, acesta este blocat până când arhiva este eliminată.
Exceptions
path’ is null.
Solicitantul nu are permisiunea necesară de acces.
path’ este gol, conține doar spații albe, sau conține caractere invalide. - sau - Numele fișierului, ca parte a
name’, depășește 100 de simboluri.
Accesul la fișierul path” este refuzat.
De exemplu, pe platforme bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere. - sau - name’ este prea lung pentru tar decât standardul IEEE 1003.1-1998.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
DeleteEntry(TarEntry)
Elimină prima apariție a unei intrări specifice din lista de intrări.
public TarArchive DeleteEntry(TarEntry entry)
Parameters
entry
TarEntry
Introducere pentru a elimina din lista de intrări.
Returns
Arhiva cu intrarea este ștersă.
Examples
Iată cum puteți șterge toate intrările, cu excepția celei din urmă:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(int)
Îndepărtează intrarea din lista de intrare prin index.
public TarArchive DeleteEntry(int entryIndex)
Parameters
entryIndex
int
Indicele de intrare bazat pe zero trebuie eliminat.
Returns
Arhiva cu intrarea este ștersă.
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()
Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.
public void Dispose()
Dispose(Boulă)
Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
În cazul în care resursele gestionate ar trebui să fie eliminate.
ExtractToDirectory(Strângere)
Extrage toate fișierele din arhivă în directorul furnizat.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Calea către directorie pentru a pune în fișierele extrase.
Examples
Using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Dacă directorul nu există, acesta va fi creat.
Exceptions
Calea este zero
Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.
Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă de disc (“C:”).
Path este o linie de lungime zero, conține doar spațiu alb, sau conțin unul sau mai multe caractere invalide. puteți solicita pentru caracări invalid prin utilizarea metodei System.IO.Path.GetInvalidPithChars. - sau - traseul este prefixat cu sau contine, doar un caracter colon (:).
Directoriul specificat de cale este un fișier. - sau - Numele rețelei nu este cunoscut.
de la GZIP(Stream)
Extracte furnizate în arhiva gzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: archivul gzip este complet extras în această metodă, conținutul său este păstrat intern.
public static TarArchive FromGZip(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție GZip nu este căutat de natura algoritmului de compresie.Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
Arhiva este coruptă.
de la GZIP(Strângere)
Extracte furnizate în arhiva gzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: archivul gzip este complet extras în această metodă, conținutul său este păstrat intern.
public static TarArchive FromGZip(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție GZip nu este căutat de natura algoritmului de compresie.Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
path’ is null.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
Arhiva este coruptă.
de la LZ4(Strângere)
Extracte furnizate în arhiva LZ4 și compune Aspose.Zip.Tar.tarArchive din datele extrase.
Important: Arhiva LZ4 este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromLZ4(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție LZ4 nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrarea arbitrară, astfel încât trebuie să funcționeze un flux de căutare sub capcană.
Exceptions
path’ is null.
Utilizatorul nu are permisiunea necesara de a accesa
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
Fișierul este prea scurt.
Dosarul are semnătura greșită.
de la LZ4(Stream)
Extracte furnizate în arhiva LZ4 și compune Aspose.Zip.Tar.tarArchive din datele extrase.
Important: Arhiva LZ4 este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromLZ4(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție LZ4 nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrarea arbitrară, astfel încât trebuie să funcționeze un flux de căutare sub capcană.
Exceptions
Nu se poate citi din source’
source’ is null.
source’ is too short.
Sursă " are semnătura greșită.
de la LZMA(Stream)
Extracte furnizate în arhiva LZMA și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: Arhiva LZMA este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromLZMA(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție LZMA nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
Arhiva este coruptă.
de la LZMA(Strângere)
Extracte furnizate în arhiva LZMA și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: Arhiva LZMA este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromLZMA(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție LZMA nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrarea arbitrară, astfel încât trebuie să funcționeze un flux de căutare sub capcană.
Exceptions
path’ is null.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
de la LZIP(Stream)
Extracte furnizate în arhiva lzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: archivul lzip este complet extras în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromLZip(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție Lzip nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
Arhiva este coruptă.
source’ is not seekable.
source’ is null.
de la LZIP(Strângere)
Extracte furnizate în arhiva lzip și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: archivul lzip este complet extras în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromLZip(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Fluxul de extracție Lzip nu este căutat prin natura algoritmului de compresie. arhivul Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
path’ is null.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
Arhiva este coruptă.
FromXz(Stream)
Extracte furnizate în arhiva formatului xz și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: archivul xz este complet extras în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromXz(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
FromXz(Strângere)
Extracte furnizate în arhiva formatului xz și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: archivul xz este complet extras în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromXz(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
path’ is null.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
din Z(Stream)
Extracte furnizate Z format arhivă și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: Arhiva Z este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromZ(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
din Z(Strângere)
Extracte furnizate Z format arhivă și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: Arhiva Z este complet extinsă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromZ(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Remarks
Arhiva Tar oferă facilitatea de a extrage înregistrări arbitrare, astfel încât trebuie să funcționeze fluxul căutat sub capcană.
Exceptions
path’ is null.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
FromZstandard(Stream)
Extracte furnizate în arhiva Zstandard și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: Arhiva standard este complet extrasă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromZstandard(Stream source)
Parameters
source
Stream
Sursă a arhivelor.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Exceptions
Fluxul Zstandard este corupt sau nu poate fi citit.
Datele sunt corupte.
FromZstandard(Strângere)
Extracte furnizate în arhiva Zstandard și compune Aspose.Zip.Tar.TarArchive din datele extrase.
Important: Arhiva standard este complet extrasă în cadrul acestei metode, conținutul său este păstrat intern.
public static TarArchive FromZstandard(string path)
Parameters
path
string
Calea către arhivă.
Returns
Un exemplu de Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path" este într-un format invalid.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul nu a fost găsit.
Fluxul Zstandard este corupt sau nu poate fi citit.
Datele sunt corupte.
Save(Războiul și TarFormat?)
Salvează arhiva la fluxul furnizat.
public void Save(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
Remarks
Trebuie să fie scrisă.
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(Războiul cu TarFormat?)
Salvează arhiva la un fișier de destinație furnizat.
public void Save(string destinationFileName, TarFormat? format = null)
Parameters
destinationFileName
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
Remarks
Este posibil să salvați un arhiv pe aceeași cale pe care a fost încărcat de la. Cu toate acestea, acest lucru nu este recomandat deoarece această abordare utilizează copierea la un fișier temporar.
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.
De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
De exemplu, destinationFileName’ este invalidă (de exemplu, este pe un disc necartat).
A apărut o eroare I/O în timpul deschiderii fișierului.
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.
Dosarul nu a fost găsit.
SaveGzipped(Războiul și TarFormat?)
Salvează arhivele în flux cu compresia gzip.
public void SaveGzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Trebuie să fie scrisă.
Exceptions
output’ is null.
output’ is not writable.
SaveGzipped(Războiul cu TarFormat?)
Salvează fișierul pe cale cu compresia gzip.
public void SaveGzipped(string path, TarFormat? format = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.
Cuvânt cheie4Compressed(Războiul și TarFormat?)
Salvează arhivele în flux cu compresia LZ4.
public void SaveLZ4Compressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Trebuie să fie scrisă.
Exceptions
output’ is null.
output’ is not writable.
Cuvânt cheie4Compressed(Războiul cu TarFormat?)
Salvează fișierul pe cale cu compresia LZ4.
public void SaveLZ4Compressed(string path, TarFormat? format = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.
salvare compresă(Războiul și TarFormat?)
Salvează arhivele în flux cu compresia LZMA.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Trebuie să fie scrisă.
Important: arhiva tar este compusă apoi comprimată în cadrul acestei metode, conținutul său este păstrat intern.
Exceptions
output’ is null.
output’ is not writable.
salvare compresă(Războiul cu TarFormat?)
Salvează fișierul pe cale cu compresia lzma.
public void SaveLZMACompressed(string path, TarFormat? format = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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: arhiva tar este compusă apoi comprimată în cadrul acestei metode, conținutul său este păstrat intern.
Exceptions
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.
SaveLzipped(Războiul și TarFormat?)
Salvează arhivele în flux cu compresia lzip.
public void SaveLzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Trebuie să fie scrisă.
Exceptions
output’ is null.
output’ is not writable.
SaveLzipped(Războiul cu TarFormat?)
Salvează fișierul pe cale cu compresia lzip.
public void SaveLzipped(string path, TarFormat? format = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.
SaveXzCompressed(Strămure, TarFormat?, XzArchiveSettings)
Salvează arhivele în flux cu compresia xz.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
settings
XzArchiveSettings
Set de setare special xz arhiv: dimensiunea dicționarului, dimensiunea blocului, tipul de verificare.
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
Fluxul trebuie să fie scris.
Exceptions
output’ is null.
output’ is not writable.
SaveXzCompressed(String, TarFormat?, XzArchiveSettings)
Salvează arhivele pe traseu prin traseu cu compresia xz.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
settings
XzArchiveSettings
Set de setare special xz arhiv: dimensiunea dicționarului, dimensiunea blocului, tipul de verificare.
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
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.
salvare compresă(Războiul și TarFormat?)
Salvează arhivele în flux cu compresia Z.
public void SaveZCompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Trebuie să fie scrisă.
Exceptions
output’ is null.
output’ is not writable.
salvare compresă(Războiul cu TarFormat?)
Salvează arhivele pe cale prin cale cu compresia Z.
public void SaveZCompressed(string path, TarFormat? format = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.
SaveZstandard(Războiul și TarFormat?)
Salvează arhivele în flux cu compresia Zstandard.
public void SaveZstandard(Stream output, TarFormat? format = null)
Parameters
output
Stream
Războiul de destinaţie.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Trebuie să fie scrisă.
Exceptions
output’ is null.
output’ is not writable.
SaveZstandard(Războiul cu TarFormat?)
Salvează fișierul pe cale cu compresia Zstandard.
public void SaveZstandard(string path, TarFormat? format = null)
Parameters
path
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
format
TarFormat
?
Definiți formatul de titlu tar. valoarea zero va fi tratată ca USTar atunci când este posibil.
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
Solicitantul nu are permisiunea solicitată. -or- path’ specificat un fișier sau directorie doar citită.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Calea specificată path’ este invalidă (de exemplu, este pe un disc necartat).
path’ is in an invalid format.