Class TarArchive
Navne til: Aspose.Zip.Tar Sammensætning: Aspose.Zip.dll (25.5.0)
Denne klasse repræsenterer en tar arkivfil. Brug det til at komponere, udveksle eller opdatere tar-arkiver.
public class TarArchive : IArchive, IDisposable
Inheritance
Implements
De arvede medlemmer
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
TarArchive()
Det initierer en ny instans af Aspose.Zip.Tar.TarArchive klasse.
public TarArchive()
Examples
Følgende eksempel viser, hvordan man komprimerer en fil.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
Initialiserer en ny instans af Aspose.Zip.Archive-klassen og komponerer en indgangsliste, der kan uddrages fra arkivet.
public TarArchive(Stream sourceStream)
Parameters
sourceStream
Stream
Arkivets kilde. det skal være søgbart.
Examples
Følgende eksempel viser, hvordan man ekstrakter alle indtægter til en katalog.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Denne konstruktør fjerner ingen indtægter. Se Aspose.Zip.Tar.TarEntry.Open metode for fjerner.
Exceptions
sourceStream’ is not seekable.
sourceStream’ is null.
TarArchive(String)
Initialiserer en ny instans af Aspose.Zip.Tar.tarArchive klasse og udgør en indgangsliste, der kan udvundes fra arkivet.
public TarArchive(string path)
Parameters
path
string
Vejen til arkiveret.
Examples
Følgende eksempel viser, hvordan man ekstrakter alle indtægter til en katalog.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Denne konstruktør fjerner ingen indtægter. Se Aspose.Zip.Tar.TarEntry.Open metode for fjerner.
Exceptions
path’ is null.
Den pågældende har ikke den nødvendige tilladelse til at få adgang.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ indeholder en kolonne (:) i midten af ringen.
Filen er ikke fundet.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er allerede åben.
Properties
Entries
Få indtægter af Aspose.Zip.Tar.TarEntry type, der udgør arkivet.
public ReadOnlyCollection<tarentry> Entries { get; }
Ejendomsværdi
ReadOnlyCollection < TarEntry >
Methods
CreateEntries(Anmeldelse: Bool)
Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
Parameters
directory
DirectoryInfo
Direktorer til komprimering.
includeRootDirectory
bool
Indikerer, om man skal inkludere selve roddokumentet eller ej.
Returns
arkiver med indtægter sammensat.
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(String og Bool)
Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
Parameters
sourceDirectory
string
Direktorer til komprimering.
includeRootDirectory
bool
Indikerer, om man skal inkludere selve roddokumentet eller ej.
Returns
arkiver med indtægter sammensat.
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.
Ringeren har ikke den nødvendige tilladelse til at få adgang til sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
Den angivne vej, filnavn, eller begge overskrider den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal vejene være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. Den angivne vej, filnavn, eller begge er for lange.
CreateEntry(String, Stream og FileSystemInfo)
Skab en enkelt indgang i arkivet.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
Parameters
name
string
Navnet på indgangen.
source
Stream
Indtægtsstrøm for indtægten.
fileInfo
FileSystemInfo
Metadata af filen eller mappen skal komprimeres.
Returns
Indtastning af indtastning af indtastning.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
Remarks
Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.
kan henvise til System.IO.DirectoryInfo, hvis indtægten er katalog.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Filnavnet, som en del af name’, overstiger 100 symboler.
CreateEntry(String, FileInfo og Bool)
Skab en enkelt indgang i arkivet.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
Parameters
name
string
Navnet på indgangen.
fileInfo
FileInfo
Metadata af filen eller mappen skal komprimeres.
openImmediately
bool
Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.
Returns
Indtastning af indtastning af indtastning.
Examples
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
Remarks
Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.
kan henvise til System.IO.DirectoryInfo, hvis indtægten er katalog.
Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.
Exceptions
name’ is too long for tar as of IEEE 1003.1-1998 standard.
Filnavnet, som en del af name’, overstiger 100 symboler.
CreateEntry(String, String og Bool)
Skab en enkelt indgang i arkivet.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
Parameters
name
string
Navnet på indgangen.
path
string
Vejen til fil at blive komprimeret.
openImmediately
bool
Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.
Returns
Indtastning af indtastning af indtastning.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
Remarks
Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.
Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.
Exceptions
path’ is null.
Den pågældende har ikke den nødvendige tilladelse til at få adgang.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn. - eller - Filnavnet, som en del af name’, overstiger 100 symboler.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme, må veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. - eller -
name’ er for lang til tar i forhold til IEEE 1003.1-1998 standard.
Filen på path’ indeholder en kolonne (:) i midten af ringen.
DeleteEntry(TarEntry)
Det fjerner den første forekomst af en bestemt indtastning fra indtastningslisten.
public TarArchive DeleteEntry(TarEntry entry)
Parameters
entry
TarEntry
Indtægten skal fjernes fra listen over indtægter.
Returns
Arkivet med indgangen er slettet.
Examples
Her er, hvordan du kan fjerne alle indtægter undtagen den sidste:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(Int)
Fjern indtægten fra indtægtslisten ved indeks.
public TarArchive DeleteEntry(int entryIndex)
Parameters
entryIndex
int
Det nulbaserede indeks af indtægten skal fjernes.
Returns
Arkivet med indgangen er slettet.
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()
Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.
public void Dispose()
Dispose(Bool)
Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Om de forvaltede ressourcer skal fjernes.
ExtractToDirectory(String)
Udveksler alle filer i arkivet til den leverede katalog.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Vejen til katalogen til at placere de udvundne filer i.
Examples
Using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Remarks
Hvis katalogen ikke eksisterer, vil den blive oprettet.
Exceptions
Vejen er null
Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.
Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.
Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“C:”).
Path er en nulllængde string, indeholder kun hvid plads, eller indeholder en eller flere invalide tegn. Du kan spørge for invalid tegn ved hjælp af System.IO.Path.GetInvalidFathChars metode. - eller - vej er forhåndsbestemt med eller indeholder kun en kolon karakter (:).
Den katalog, der er angivet af vejen, er en fil. - eller - Netværksnavnet er ikke kendt.
af Zip(Stream)
Ekstrakter leveret gzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: gzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromGZip(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
GZip ekstraktionsstrøm kan ikke søges af komprimeringsalgoritmens natur.Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.
Exceptions
Arkiverne er korrupte.
af Zip(String)
Ekstrakter leveret gzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: gzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromGZip(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
GZip ekstraktionsstrøm kan ikke søges af komprimeringsalgoritmens natur.Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.
Exceptions
path’ is null.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
Arkiverne er korrupte.
af LZ4(String)
Ekstrakter leveret LZ4 arkiv og komponerer Aspose.Zip.Tar.tarArchive fra udvundet data.
Vigtigt: LZ4 arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromLZ4(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
LZ4 ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har til at operere søgbare strømme under hoden.
Exceptions
path’ is null.
Anmelderen har ikke den nødvendige tilladelse til at få adgang
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
Filen er for kort.
Filen har den forkerte underskrift.
af LZ4(Stream)
Ekstrakter leveret LZ4 arkiv og komponerer Aspose.Zip.Tar.tarArchive fra udvundet data.
Vigtigt: LZ4 arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromLZ4(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
LZ4 ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har til at operere søgbare strømme under hoden.
Exceptions
Kan ikke læses fra source’
source’ is null.
source’ is too short.
source’ har den forkerte underskrift.
af LZMA(Stream)
Ekstrakter leveret LZMA arkiver og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: LZMA arkiver er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromLZMA(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
LZMA ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det skal operere søgbart strøm under hoden.
Exceptions
Arkiverne er korrupte.
af LZMA(String)
Ekstrakter leveret LZMA arkiver og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: LZMA arkiver er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromLZMA(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
LZMA ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har til at operere søgbare strømme under hoden.
Exceptions
path’ is null.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
af Zip(Stream)
Ekstrakter leveret lzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: lzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromLZip(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
Lzip ekstraktionsstrøm er ikke søgbart af natur af komprimering algoritme. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har at operere søgbart strøm under hoden.
Exceptions
Arkiverne er korrupte.
source’ is not seekable.
source’ is null.
af Zip(String)
Ekstrakter leveret lzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: lzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromLZip(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
Lzip ekstraktionsstrøm er ikke søgbart af natur af komprimering algoritme. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har at operere søgbart strøm under hoden.
Exceptions
path’ is null.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
Arkiverne er korrupte.
FromXz(Stream)
Ekstrakter leveret xz format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: xz arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromXz(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.
FromXz(String)
Ekstrakter leveret xz format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: xz arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromXz(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.
Exceptions
path’ is null.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
Fra Z(Stream)
Ekstrakter leveret Z-format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra de udvundne data.
Vigtigt: Z arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromZ(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.
Fra Z(String)
Ekstrakter leveret Z-format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra de udvundne data.
Vigtigt: Z arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromZ(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Remarks
Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.
Exceptions
path’ is null.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
FromZstandard(Stream)
Ekstrakter leveret Zstandard arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: Standard arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromZstandard(Stream source)
Parameters
source
Stream
kilden til arkivet.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Exceptions
Den almindelige strøm er korrumperet eller ikke læses.
Data er korrupte.
FromZstandard(String)
Ekstrakter leveret Zstandard arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.
Vigtigt: Standard arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.
public static TarArchive FromZstandard(string path)
Parameters
path
string
Vejen til arkiveret.
Returns
Et eksempel på Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.
Tilgang til filen path’ er nægtet.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Filen på path’ er i et ugyldigt format.
Den angivne rute er ugyldig, f.eks. på en ubemappet drive.
Filen er ikke fundet.
Den almindelige strøm er korrumperet eller ikke læses.
Data er korrupte.
Save(Strøm eller TarFormat?)
Sparer arkiver til den leverede strøm.
public void Save(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
Examples
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
Remarks
Det skal være skriftligt.
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(String og TarFormat?)
Sparer arkiver til en bestemmelsesfil, der er leveret.
public void Save(string destinationFileName, TarFormat? format = null)
Parameters
destinationFileName
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
Examples
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
Remarks
Det er muligt at gemme et arkiv på samme vej, som det blev lastet fra. dog anbefales dette ikke, fordi denne tilgang bruger kopiering til en midlertidig fil.
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.
Den angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne destinationFileName’ er ugyldig (f.eks. den er på en ikke-mapped disk).
En I/O-fejl opstod under åbningen af filen.
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.
Filen er ikke fundet.
SaveGzipped(Strøm eller TarFormat?)
Sparer arkiver til strømmen med gzip-kompression.
public void SaveGzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Det skal være skriftligt.
Exceptions
output’ is null.
output’ is not writable.
SaveGzipped(String og TarFormat?)
Sparer arkiver til filen ved hjælp af gzip-kompression.
public void SaveGzipped(string path, TarFormat? format = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.
L4 komprimeret(Strøm eller TarFormat?)
Sparer arkiver til strømen med LZ4 kompression.
public void SaveLZ4Compressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Det skal være skriftligt.
Exceptions
output’ is null.
output’ is not writable.
L4 komprimeret(String og TarFormat?)
Sparer arkiver til filen ved hjælp af LZ4 kompression.
public void SaveLZ4Compressed(string path, TarFormat? format = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.
Sikkerhed komprimeret(Strøm eller TarFormat?)
Sparer arkiver til strømen med LZMA-kompression.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Det skal være skriftligt.
Vigtigt: tar arkiver er sammensat og komprimeret inden for denne metode, dens indhold bevares internalt.
Exceptions
output’ is null.
output’ is not writable.
Sikkerhed komprimeret(String og TarFormat?)
Sparer arkiver til filen ved hjælp af lzma kompression.
public void SaveLZMACompressed(string path, TarFormat? format = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Vigtigt: tar arkiver er sammensat og komprimeret inden for denne metode, dens indhold bevares internalt.
Exceptions
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.
SaveLzipped(Strøm eller TarFormat?)
Sparer arkiver til strømen med lzip-kompression.
public void SaveLzipped(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Det skal være skriftligt.
Exceptions
output’ is null.
output’ is not writable.
SaveLzipped(String og TarFormat?)
Sparer arkiver til filen ved hjælp af lzip-kompression.
public void SaveLzipped(string path, TarFormat? format = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.
SaveXzCompressed(Strøm, TarFormat?, XzArchiveSettings)
Sparer arkiver til strømen med xz-kompression.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
settings
XzArchiveSettings
Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.
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
Strømmen skal være skriftlig.
Exceptions
output’ is null.
output’ is not writable.
SaveXzCompressed(String, TarFormat?, XzArchiveSettings)
Sparer arkiver til vejen ved vejen med xz kompression.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
settings
XzArchiveSettings
Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.
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
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.
Beskyttelse komprimeret(Strøm eller TarFormat?)
Sparer arkiver til strømen med Z-kompression.
public void SaveZCompressed(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Det skal være skriftligt.
Exceptions
output’ is null.
output’ is not writable.
Beskyttelse komprimeret(String og TarFormat?)
Sparer arkiver til vejen ved vejen med Z-kompression.
public void SaveZCompressed(string path, TarFormat? format = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.
SaveZstandard(Strøm eller TarFormat?)
Sparer arkiver til strømen med Zstandard kompression.
public void SaveZstandard(Stream output, TarFormat? format = null)
Parameters
output
Stream
Destinationstrøm.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Det skal være skriftligt.
Exceptions
output’ is null.
output’ is not writable.
SaveZstandard(String og TarFormat?)
Sparer arkiver til filen efter vej med Zstandard kompression.
public void SaveZstandard(string path, TarFormat? format = null)
Parameters
path
string
Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.
format
TarFormat
?
Null værdi vil blive behandlet som USTar, når det er muligt.
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
Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene fil eller katalog.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.
Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).
path’ is in an invalid format.