Class TarArchive
Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)
Denna klass representerar en tar-arkivfil. Använd den för att kompilera, extrahera eller uppdatera tar-arkiv.
public class TarArchive : IArchive, IDisposable
Arv
Implementerar
Arvda medlemmar
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktörer
TarArchive()
Initierar en ny instans av Aspose.Zip.Tar.TarArchive-klassen.
public TarArchive()
Exempel
Följande exempel visar hur man komprimerar en fil.
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save("archive.tar");
}
TarArchive(Stream)
Initierar en ny instans av Aspose.Zip.Archive-klassen och komponerar en lista med poster som kan extraheras från arkivet.
public TarArchive(Stream sourceStream)
Parametrar
sourceStream
Stream
Källan till arkivet. Den måste vara sökbar.
Exempel
Följande exempel visar hur man extraherar alla poster till en katalog.
using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{
archive.ExtractToDirectory("C:\extracted");
}
Anmärkningar
Denna konstruktor packar inte upp någon post. Se Aspose.Zip.Tar.TarEntry.Open-metoden för uppackning.
Undantag
sourceStream
är inte sökbar.
TarArchive(string)
Initierar en ny instans av Aspose.Zip.Tar.TarArchive-klassen och komponerar en lista med poster som kan extraheras från arkivet.
public TarArchive(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Exempel
Följande exempel visar hur man extraherar alla poster till en katalog.
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Anmärkningar
Denna konstruktor packar inte upp någon post. Se Aspose.Zip.Tar.TarEntry.Open-metoden för uppackning.
Undantag
path
är null.
Anroparen har inte de nödvändiga behörigheterna för att få åtkomst.
path
är tom, innehåller endast vita tecken eller innehåller ogiltiga tecken.
Åtkomst till filen path
är nekad.
Den angivna path
, filnamn, eller båda överskrider systemets maximala längd. Till exempel, på Windows-baserade plattformar måste sökvägar vara kortare än 248 tecken, och filnamn måste vara kortare än 260 tecken.
Fil på path
innehåller ett kolon (:) i mitten av strängen.
Filen hittades inte.
Den angivna sökvägen är ogiltig, till exempel om den ligger på en icke-mappad enhet.
Filen är redan öppen.
Egenskaper
Entries
Får poster av Aspose.Zip.Tar.TarEntry-typ som utgör arkivet.
public ReadOnlyCollection<tarentry> Entries { get; }
Egenskapsvärde
ReadOnlyCollection<TarEntry>
Metoder
CreateEntries(DirectoryInfo, bool)
Lägger till alla filer och kataloger rekursivt i den angivna katalogen till arkivet.
public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)
Parametrar
directory
DirectoryInfo
Katalogen att komprimera.
includeRootDirectory
bool
Anger om root-katalogen själv ska inkluderas eller inte.
Returer
Arkivet med komponerade poster.
Exempel
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
archive.Save(tarFile);
}
}
CreateEntries(string, bool)
Lägger till alla filer och kataloger rekursivt i den angivna katalogen till arkivet.
public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)
Parametrar
sourceDirectory
string
Katalogen att komprimera.
includeRootDirectory
bool
Anger om root-katalogen själv ska inkluderas eller inte.
Returer
Arkivet med komponerade poster.
Exempel
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntries("C:\folder", false);
archive.Save(tarFile);
}
}
Undantag
sourceDirectory
är null.
Anroparen har inte de nödvändiga behörigheterna för att få åtkomst till sourceDirectory
.
sourceDirectory
innehåller ogiltiga tecken som “, <, > eller |.
Den angivna sökvägen, filnamnet, eller båda överskrider systemets maximala längd. Till exempel, på Windows-baserade plattformar, måste sökvägar vara kortare än 248 tecken, och filnamn måste vara kortare än 260 tecken. Den angivna sökvägen, filnamnet, eller båda är för långa.
CreateEntry(string, Stream, FileSystemInfo)
Skapar en enda post inom arkivet.
public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
Parametrar
name
string
Namnet på posten.
source
Stream
Indataflödet för posten.
fileInfo
FileSystemInfo
Metadata för fil eller mapp som ska komprimeras.
Returer
Instans av TarEntry.
Exempel
using (var archive = new TarArchive())
{
archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
archive.Save(tarFile);
}
Anmärkningar
Postnamnet sätts enbart inom name
-parametern. Filnamnet som anges i fileInfo
-parametern påverkar inte postnamnet.
fileInfo
kan referera till System.IO.DirectoryInfo om posten är en katalog.
Undantag
name
är för långt för tar enligt IEEE 1003.1-1998-standarden.
Filnamnet, som en del av name
, överskrider 100 tecken.
CreateEntry(string, FileInfo, bool)
Skapar en enda post inom arkivet.
public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
Parametrar
name
string
Namnet på posten.
fileInfo
FileInfo
Metadata för fil eller mapp som ska komprimeras.
openImmediately
bool
True om filen ska öppnas omedelbart, annars öppnas filen vid arkivets sparande.
Returer
Instans av TarEntry.
Exempel
FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
archive.CreateEntry("data.bin", fi);
archive.Save(tarFile);
}
Anmärkningar
Postnamnet sätts enbart inom name
-parametern. Filnamnet som anges i fileInfo
-parametern påverkar inte postnamnet.
fileInfo
kan referera till System.IO.DirectoryInfo om posten är en katalog.
Om filen öppnas omedelbart med openImmediately
-parametern blir den blockerad tills arkivet är avyttrat.
Undantag
name
är för långt för tar enligt IEEE 1003.1-1998-standarden.
Filnamnet, som en del av name
, överskrider 100 tecken.
CreateEntry(string, string, bool)
Skapar en enda post inom arkivet.
public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
Parametrar
name
string
Namnet på posten.
path
string
Sökväg till filen som ska komprimeras.
openImmediately
bool
True om filen ska öppnas omedelbart, annars öppnas filen vid arkivets sparande.
Returer
Instans av TarEntry.
Exempel
using (var archive = new TarArchive())
{
archive.CreateEntry("first.bin", "data.bin");
archive.Save(outputTarFile);
}
Anmärkningar
Postnamnet sätts enbart inom name
-parametern. Filnamnet som anges i path
-parametern påverkar inte postnamnet.
Om filen öppnas omedelbart med openImmediately
-parametern blir den blockerad tills arkivet är avyttrat.
Undantag
path
är null.
Anroparen har inte de nödvändiga behörigheterna för att få åtkomst.
path
är tom, innehåller endast vita tecken eller innehåller ogiltiga tecken. - eller - Filnamnet, som en del av name
, överskrider 100 tecken.
Åtkomst till filen path
är nekad.
Den angivna path
, filnamnet, eller båda överskrider systemets maximala längd. Till exempel, på Windows-baserade plattformar, måste sökvägar vara kortare än 248 tecken, och filnamn måste vara kortare än 260 tecken. - eller - name
är för långt för tar enligt IEEE 1003.1-1998-standarden.
Fil på path
innehåller ett kolon (:) i mitten av strängen.
DeleteEntry(TarEntry)
Tar bort den första förekomsten av en specifik post från listan med poster.
public TarArchive DeleteEntry(TarEntry entry)
Parametrar
entry
TarEntry
Den post som ska tas bort från listan med poster.
Returer
Arkivet med den borttagna posten.
Exempel
Här är hur du kan ta bort alla poster förutom den sista:
using (var archive = new TarArchive("archive.tar"))
{
while (archive.Entries.Count > 1)
archive.DeleteEntry(archive.Entries[0]);
archive.Save(outputTarFile);
}
DeleteEntry(int)
Tar bort posten från listan med poster efter index.
public TarArchive DeleteEntry(int entryIndex)
Parametrar
entryIndex
int
Det nollbaserade indexet för posten som ska tas bort.
Returer
Arkivet med den borttagna posten.
Exempel
using (var archive = new TarArchive("two_files.tar"))
{
archive.DeleteEntry(0);
archive.Save("single_file.tar");
}
Undantag
entryIndex
är mindre än 0.-eller- entryIndex
är lika med eller större än Entries
-antalet.
Dispose()
Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.
public void Dispose()
Dispose(bool)
Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa icke-hanterade resurser.
protected virtual void Dispose(bool disposing)
Parametrar
disposing
bool
Om hanterade resurser ska avyttras.
ExtractToDirectory(string)
Extraherar alla filer i arkivet till den angivna katalogen.
public void ExtractToDirectory(string destinationDirectory)
Parametrar
destinationDirectory
string
Sökvägen till katalogen där de extraherade filerna ska placeras.
Exempel
using (var archive = new TarArchive("archive.tar"))
{
archive.ExtractToDirectory("C:\extracted");
}
Anmärkningar
Om katalogen inte finns, kommer den att skapas.
Undantag
path är null
Den angivna sökvägen, filnamnet, eller båda överskrider systemets maximala längd. Till exempel, på Windows-baserade plattformar, måste sökvägar vara kortare än 248 tecken och filnamn måste vara kortare än 260 tecken.
Anroparen har inte de nödvändiga behörigheterna för att få åtkomst till den befintliga katalogen.
Om katalogen inte finns, innehåller sökvägen ett kolon-tecken (:) som inte är en del av en enhetsbeteckning (“C:").
Sökvägen är en sträng med noll längd, innehåller endast vita tecken eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken genom att använda System.IO.Path.GetInvalidPathChars-metoden. -eller- Sökvägen är förkortad med, eller innehåller, endast ett kolon-tecken (:).
Den katalog som anges av sökvägen är en fil. -eller- Det nätverksnamnet är inte känt.
FromGZip(Stream)
Extraherar den angivna gzip-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: gzip-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromGZip(Stream source)
Parametrar
source
Stream
Källan till arkivet.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
GZip-extraktionsströmmen är inte sökbar på grund av komprimeringsalgoritmens natur. Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
Undantag
Arkivet är skadat.
FromGZip(string)
Extraherar den angivna gzip-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: gzip-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromGZip(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
GZip-extraktionsströmmen är inte sökbar på grund av komprimeringsalgoritmens natur. Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
Undantag
Arkivet är skadat.
FromLZMA(Stream)
Extraherar den angivna LZMA-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: LZMA-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromLZMA(Stream source)
Parametrar
source
Stream
Källan till arkivet.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
LZMA-extraktionsströmmen är inte sökbar på grund av komprimeringsalgoritmens natur. Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromLZMA(string)
Extraherar den angivna LZMA-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: LZMA-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromLZMA(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
LZMA-extraktionsströmmen är inte sökbar på grund av komprimeringsalgoritmens natur. Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromLZip(Stream)
Extraherar den angivna lzip-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: lzip-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromLZip(Stream source)
Parametrar
source
Stream
Källan till arkivet.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
Lzip-extraktionsströmmen är inte sökbar på grund av komprimeringsalgoritmens natur. Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromLZip(string)
Extraherar den angivna lzip-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: lzip-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromLZip(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
Lzip-extraktionsströmmen är inte sökbar på grund av komprimeringsalgoritmens natur. Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromXz(Stream)
Extraherar den angivna xz-format arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: xz-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromXz(Stream source)
Parametrar
source
Stream
Källan till arkivet.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromXz(string)
Extraherar den angivna xz-format arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: xz-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromXz(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromZ(Stream)
Extraherar den angivna Z-format arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: Z-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromZ(Stream source)
Parametrar
source
Stream
Källan till arkivet.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromZ(string)
Extraherar den angivna Z-format arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: Z-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromZ(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Anmärkningar
Tar-arkivet tillhandahåller möjligheten att extrahera godtycklig post, så det måste fungera med en sökbar ström under huven.
FromZstandard(Stream)
Extraherar den angivna Zstandard-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: Zstandard-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromZstandard(Stream source)
Parametrar
source
Stream
Källan till arkivet.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Undantag
Zstandard-strömmen är skadad eller inte läsbar.
Data är skadad.
FromZstandard(string)
Extraherar den angivna Zstandard-arkivet och komponerar Aspose.Zip.Tar.TarArchive från de extraherade data.
Viktigt: Zstandard-arkivet extraheras helt inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
public static TarArchive FromZstandard(string path)
Parametrar
path
string
Sökvägen till arkivfilen.
Returer
En instans av Aspose.Zip.Tar.TarArchive
Undantag
Zstandard-strömmen är skadad eller inte läsbar.
Data är skadad.
Save(Stream, TarFormat?)
Sparar arkivet till den angivna strömmen.
public void Save(Stream output, TarFormat? format = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save(tarFile);
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är inte skrivbar. - eller - output
är samma ström som vi extraherar från.
- ELLER -
Det är omöjligt att spara arkivet i format
på grund av formatrestriktioner.
Save(string, TarFormat?)
Sparar arkivet till destinationfilen som anges.
public void Save(string destinationFileName, TarFormat? format = null)
Parametrar
destinationFileName
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
using (var archive = new TarArchive())
{
archive.CreateEntry("entry1", "data.bin");
archive.Save("myarchive.tar");
}
Anmärkningar
Det är möjligt att spara ett arkiv till samma sökväg som det laddades från. Men detta rekommenderas inte eftersom denna metod använder kopiering till en temporär fil.
Undantag
destinationFileName
är en sträng med noll längd, innehåller endast vita tecken eller innehåller ett eller flera ogiltiga tecken som definieras av System.IO.Path.InvalidPathChars.
destinationFileName
är null.
Den angivna destinationFileName
, filnamnet, eller båda överskrider systemets maximala längd. Till exempel, på Windows-baserade plattformar, måste sökvägar vara kortare än 248 tecken, och filnamn måste vara kortare än 260 tecken.
Den angivna destinationFileName
är ogiltig, (till exempel, den ligger på en icke-mappad enhet).
Ett I/O-fel inträffade när filen öppnades.
destinationFileName
angav en fil som är skrivskyddad och åtkomst är inte läsbar.-eller- sökvägen angav en katalog.-eller- Anroparen har inte de nödvändiga behörigheterna.
destinationFileName
är i ett ogiltigt format.
Filen hittades inte.
SaveGzipped(Stream, TarFormat?)
Sparar arkivet till strömmen med gzip-komprimering.
public void SaveGzipped(Stream output, TarFormat? format = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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);
}
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är null.
output
är inte skrivbar.
SaveGzipped(string, TarFormat?)
Sparar arkivet till filen via sökvägen med gzip-komprimering.
public void SaveGzipped(string path, TarFormat? format = null)
Parametrar
path
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.gz");
}
}
SaveLZMACompressed(Stream, TarFormat?)
Sparar arkivet till strömmen med LZMA-komprimering.
public void SaveLZMACompressed(Stream output, TarFormat? format = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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);
}
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är null.
output
är inte skrivbar.
SaveLZMACompressed(string, TarFormat?)
Sparar arkivet till filen via sökvägen med lzma-komprimering.
public void SaveLZMACompressed(string path, TarFormat? format = null)
Parametrar
path
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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");
}
}
Anmärkningar
Viktigt: tar-arkivet komponerades och komprimerades inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.
SaveLzipped(Stream, TarFormat?)
Sparar arkivet till strömmen med lzip-komprimering.
public void SaveLzipped(Stream output, TarFormat? format = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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);
}
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är null.
output
är inte skrivbar.
SaveLzipped(string, TarFormat?)
Sparar arkivet till filen via sökvägen med lzip-komprimering.
public void SaveLzipped(string path, TarFormat? format = null)
Parametrar
path
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveGzipped("result.tar.lz");
}
}
SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)
Sparar arkivet till strömmen med xz-komprimering.
public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
settings
XzArchiveSettings
En uppsättning inställningar för den specifika xz-arkivet: ordboksstorlek, blockstorlek, kontrolltyp.
Exempel
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);
}
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är null.
output
är inte skrivbar.
SaveXzCompressed(string, TarFormat?, XzArchiveSettings)
Sparar arkivet till sökvägen med xz-komprimering.
public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)
Parametrar
path
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
settings
XzArchiveSettings
En uppsättning inställningar för den specifika xz-arkivet: ordboksstorlek, blockstorlek, kontrolltyp.
Exempel
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveXzCompressed("result.tar.xz");
}
}
SaveZCompressed(Stream, TarFormat?)
Sparar arkivet till strömmen med Z-komprimering.
public void SaveZCompressed(Stream output, TarFormat? format = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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);
}
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är null.
output
är inte skrivbar.
SaveZCompressed(string, TarFormat?)
Sparar arkivet till sökvägen med Z-komprimering.
public void SaveZCompressed(string path, TarFormat? format = null)
Parametrar
path
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
using (var archive = new TarArchive())
{
archive.CreateEntry("entry.bin", source);
archive.SaveZCompressed("result.tar.Z");
}
}
SaveZstandard(Stream, TarFormat?)
Sparar arkivet till strömmen med Zstandard-komprimering.
public void SaveZstandard(Stream output, TarFormat? format = null)
Parametrar
output
Stream
Destinationström.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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);
}
}
}
Anmärkningar
output
måste vara skrivbar.
Undantag
output
är null.
output
är inte skrivbar.
SaveZstandard(string, TarFormat?)
Sparar arkivet till filen via sökvägen med Zstandard-komprimering.
public void SaveZstandard(string path, TarFormat? format = null)
Parametrar
path
string
Sökvägen till arkivet som ska skapas. Om det angivna filnamnet pekar på en befintlig fil kommer den att skrivas över.
format
TarFormat?
Definierar tar-headerformatet. Null-värdet kommer att behandlas som USTar när det är möjligt.
Exempel
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");
}
}