Class TarArchive

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

objectTarArchive

Implementerar

IArchive, IDisposable

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

InvalidDataException

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

ArgumentNullException

path är null.

SecurityException

Anroparen har inte de nödvändiga behörigheterna för att få åtkomst.

ArgumentException

path är tom, innehåller endast vita tecken eller innehåller ogiltiga tecken.

UnauthorizedAccessException

Åtkomst till filen path är nekad.

PathTooLongException

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.

NotSupportedException

Fil på path innehåller ett kolon (:) i mitten av strängen.

FileNotFoundException

Filen hittades inte.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig, till exempel om den ligger på en icke-mappad enhet.

IOException

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&gt;

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

TarArchive

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

TarArchive

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

ArgumentNullException

sourceDirectory är null.

SecurityException

Anroparen har inte de nödvändiga behörigheterna för att få åtkomst till sourceDirectory.

ArgumentException

sourceDirectory innehåller ogiltiga tecken som “, <, > eller |.

PathTooLongException

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

TarEntry

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

PathTooLongException

name är för långt för tar enligt IEEE 1003.1-1998-standarden.

ArgumentException

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

TarEntry

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

PathTooLongException

name är för långt för tar enligt IEEE 1003.1-1998-standarden.

ArgumentException

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

TarEntry

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

ArgumentNullException

path är null.

SecurityException

Anroparen har inte de nödvändiga behörigheterna för att få åtkomst.

ArgumentException

path är tom, innehåller endast vita tecken eller innehåller ogiltiga tecken. - eller - Filnamnet, som en del av name, överskrider 100 tecken.

UnauthorizedAccessException

Åtkomst till filen path är nekad.

PathTooLongException

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.

NotSupportedException

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

TarArchive

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 &gt; 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

TarArchive

Arkivet med den borttagna posten.

Exempel

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

Undantag

ArgumentOutOfRangeException

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

ArgumentNullException

path är null

PathTooLongException

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.

SecurityException

Anroparen har inte de nödvändiga behörigheterna för att få åtkomst till den befintliga katalogen.

NotSupportedException

Om katalogen inte finns, innehåller sökvägen ett kolon-tecken (:) som inte är en del av en enhetsbeteckning (“C:").

ArgumentException

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

IOException

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

TarArchive

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

InvalidDataException

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

TarArchive

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

InvalidDataException

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

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

TarArchive

En instans av Aspose.Zip.Tar.TarArchive

Undantag

IOException

Zstandard-strömmen är skadad eller inte läsbar.

InvalidDataException

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

TarArchive

En instans av Aspose.Zip.Tar.TarArchive

Undantag

IOException

Zstandard-strömmen är skadad eller inte läsbar.

InvalidDataException

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

ArgumentException

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

ArgumentException

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.

ArgumentNullException

destinationFileName är null.

PathTooLongException

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.

DirectoryNotFoundException

Den angivna destinationFileName är ogiltig, (till exempel, den ligger på en icke-mappad enhet).

IOException

Ett I/O-fel inträffade när filen öppnades.

UnauthorizedAccessException

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.

NotSupportedException

destinationFileName är i ett ogiltigt format.

FileNotFoundException

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

ArgumentNullException

output är null.

ArgumentException

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.

Viktigt: tar-arkivet komponerades och komprimerades inom denna metod, dess innehåll hålls internt. Var försiktig med minnesanvändningen.

Undantag

ArgumentNullException

output är null.

ArgumentException

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

ArgumentNullException

output är null.

ArgumentException

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

ArgumentNullException

output är null.

ArgumentException

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

ArgumentNullException

output är null.

ArgumentException

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

ArgumentNullException

output är null.

ArgumentException

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");
    }
}
 Svenska