Class TarArchive

Class TarArchive

Namn på plats: Aspose.Zip.Tar Sammanfattning: Aspose.Zip.dll (25.5.0)

Denna klass representerar en tar arkivfil. Använd den för att komponera, extrahera eller uppdatera tararkiv.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Arvsmedlemmar

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

TarArchive()

Initialiserar en ny instans av Aspose.Zip.Tar.TarArchive klass.

public TarArchive()

Examples

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)

Initialiserar en ny instans av Aspose.Zip.Archive-klassen och utgör en inlistan som kan extraheras från arkivet.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Källan till arkivet. det måste vara sökbart.

Examples

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

Remarks

Denna konstruktör avpackar inte någon inmatning. Se Aspose.Zip.Tar.TarEntry.Öppna metoden för avpackning.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Sträng)

Initialiserar en ny instans av Aspose.Zip.Tar.tarArchive-klassen och utgör en inlistan som kan extraheras från arkivet.

public TarArchive(string path)

Parameters

path string

Vägen till arkivfilen.

Examples

Följande exempel visar hur man extraherar alla poster till en katalog.

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Denna konstruktör avpackar inte någon inmatning. Se Aspose.Zip.Tar.TarEntry.Öppna metoden för avpackning.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

FileNotFoundException

Filen hittades inte.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

IOException

Filen är redan öppen.

Properties

Entries

Få inmatningar av Aspose.Zip.Tar.TarEntry-typ som utgör arkivet.

public ReadOnlyCollection<tarentry> Entries { get; }

Fastighetsvärde

ReadOnlyCollection ochlt; TarEntry >

Methods

CreateEntries(Föregående inlägg: Bool)

Lägg till arkivet alla filer och kataloger återkommande i den angivna katalogen.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

Parameters

directory DirectoryInfo

katalog för komprimering.

includeRootDirectory bool

Anger om du ska inkludera rötdiagrammet själv eller inte.

Returns

TarArchive

Arkiv med ingångar komposterade.

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 och bool)

Lägg till arkivet alla filer och kataloger återkommande i den angivna katalogen.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Parameters

sourceDirectory string

katalog för komprimering.

includeRootDirectory bool

Anger om du ska inkludera rötdiagrammet själv eller inte.

Returns

TarArchive

Arkiv med ingångar komposterade.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

Ringaren har inte nödvändig tillstånd att komma åt sourceDirectory'.

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamnen måste vara mindre än 260 tecken.

CreateEntry(sträng, ström, FileSystemInfo)

Skapa en enda inmatning inom arkivet.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Parameters

name string

Namnet på ingången.

source Stream

Inträdesflöde för ingången.

fileInfo FileSystemInfo

Metadata av filen eller mappen ska komprimeras.

Returns

TarEntry

Tar inträdesinstans.

Examples

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Remarks

Innehållsnamnet anges endast inom parameter. filnamnet som anges i parameter påverkar inte innehållsnamnet.

kan hänvisa till System.IO.DirectoryInfo om entréen är katalog.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

Filnamnet, som en del av name’, överstiger 100 symboler.

CreateEntry(sträng, FileInfo, bool)

Skapa en enda inmatning inom arkivet.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

Parameters

name string

Namnet på ingången.

fileInfo FileInfo

Metadata av filen eller mappen ska komprimeras.

openImmediately bool

Det är sant, om du öppnar filen omedelbart, annars öppnar du filen på arkivspara.

Returns

TarEntry

Tar inträdesinstans.

Examples

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Remarks

Innehållsnamnet anges endast inom parameter. filnamnet som anges i parameter påverkar inte innehållsnamnet.

kan hänvisa till System.IO.DirectoryInfo om entréen är katalog.

Om filen öppnas omedelbart med parameter blockeras den tills arkivet är borta.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

Filnamnet, som en del av name’, överstiger 100 symboler.

CreateEntry(String, String och Bool)

Skapa en enda inmatning inom arkivet.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Parameters

name string

Namnet på ingången.

path string

Vägen att filera för att komprimeras.

openImmediately bool

Det är sant, om du öppnar filen omedelbart, annars öppnar du filen på arkivspara.

Returns

TarEntry

Tar inträdesinstans.

Examples

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save(outputTarFile);
}

Remarks

Innehållsnamnet anges endast inom parameter. filnamnet som anges i parameter påverkar inte innehållsnamnet.

Om filen öppnas omedelbart med parameter blockeras den tills arkivet är borta.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller invalid tecken. - eller - Filnamnet, som en del av name’, överstiger 100 symboler.

UnauthorizedAccessException

Tillgång till filen path” vägras.

PathTooLongException

Den angivna path’, filnamnet, eller båda överstiger den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar, måste vägar vara mindre än 248 tecken, och filnamnen måste vara mindre än 260 tecken. - eller - name’ är för lång för tar jämfört med IEEE 1003.1-1998 standard.

NotSupportedException

Filen på path’ innehåller en kolumn (:) i mitten av raden.

DeleteEntry(TarEntry)

Ta bort den första förekomsten av en viss inmatning från inmatningslistan.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Inträde att ta bort från listan inträde.

Returns

TarArchive

Arkivet med ingången raderas.

Examples

Här är hur du kan ta bort alla poster utom 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)

Ta bort inmatningen från inmatningslistan per index.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Nollbaserad index för inmatning att ta bort.

Returns

TarArchive

Arkivet med ingången raderas.

Examples

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

Exceptions

ArgumentOutOfRangeException

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

Dispose()

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

public void Dispose()

Dispose(Bool)

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Oavsett om de förvaltade resurserna ska utplånas.

ExtractToDirectory(Sträng)

Extraherar alla filer i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Vägen till katalogen för att placera de extraherade filerna i.

Examples

Using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Om katalogen inte existerar kommer den att skapas.

Exceptions

ArgumentNullException

Vägen är noll

PathTooLongException

Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägarna vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.

SecurityException

Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.

NotSupportedException

Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“C:”).

ArgumentException

Path är en noll längd sträng, innehåller endast vitt utrymme, eller innehåller en eller flera invalid tecken. Du kan söka om invalid karaktärer genom att använda System.IO.Path.GetInvalidFathChars metod. - eller - spåren är förfäst med eller innefattar endast en kolumnkaraktär (:).

IOException

Den katalog som anges av vägen är en fil. - eller - Nätverksnamnet är inte känt.

från Zip(Stream)

Extrakt levereras i gzip arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: gzip arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

GZip extraktionsström är inte sökbar av typen av komprimering algoritm.Tar arkiv ger möjlighet att extrahera vilseledande rekord, så det måste driva sökbar ström under höljet.

Exceptions

InvalidDataException

Arkivet är korrupt.

från Zip(Sträng)

Extrakt levereras i gzip arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: gzip arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromGZip(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

GZip extraktionsström är inte sökbar av typen av komprimering algoritm.Tar arkiv ger möjlighet att extrahera vilseledande rekord, så det måste driva sökbar ström under höljet.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

InvalidDataException

Arkivet är korrupt.

från LZ4(Sträng)

Extrakt levereras LZ4 arkiv och komponerar Aspose.Zip.Tar.tarArchive från extraherade data.

Viktigt: LZ4 arkiv extraheras helt inom denna metod, dess innehåll hålls intern.

public static TarArchive FromLZ4(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

LZ4 extraktionsström är inte sökbar av typen av komprimering algoritm. Tar arkiv ger möjlighet att extrahera arbitrarisk rekord, så det måste driva sökbara ström under hål.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Sökanden har inte behörig tillstånd att komma åt

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

EndOfStreamException

Filen är för kort.

InvalidDataException

Filen har fel signatur.

från LZ4(Stream)

Extrakt levereras LZ4 arkiv och komponerar Aspose.Zip.Tar.tarArchive från extraherade data.

Viktigt: LZ4 arkiv extraheras helt inom denna metod, dess innehåll hålls intern.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

LZ4 extraktionsström är inte sökbar av typen av komprimering algoritm. Tar arkiv ger möjlighet att extrahera arbitrarisk rekord, så det måste driva sökbara ström under hål.

Exceptions

ArgumentException

Kan inte läsas från source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

Källan " har fel signatur.

från LZMA(Stream)

Extrakt levereras LZMA arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: LZMA arkiv extraheras helt inom denna metod, dess innehåll hålls intern.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

LZMA utvinning ström är inte sökbar av karaktären av komprimering algoritm. Tar arkiv ger möjlighet att extrahera önskvärt rekord, så det måste driva sökbar ström under locket.

Exceptions

InvalidDataException

Arkivet är korrupt.

från LZMA(Sträng)

Extrakt levereras LZMA arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: LZMA arkiv extraheras helt inom denna metod, dess innehåll hålls intern.

public static TarArchive FromLZMA(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

LZMA extraktionsström är inte sökbar av typen av komprimering algoritm. Tar arkiv ger möjlighet att extrahera arbitrarisk rekord, så det måste driva sökbara ström under hål.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

frånLZip(Stream)

Extrakt levereras i lzip arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: lzip arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

Lzip utvinning ström är inte sökbar av karaktären av komprimering algoritm. Tar arkiv ger möjlighet att extrahera arbitrarisk rekord, så det måste driva sökbar ström under locket.

Exceptions

InvalidDataException

Arkivet är korrupt.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

frånLZip(Sträng)

Extrakt levereras i lzip arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: lzip arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromLZip(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

Lzip utvinning ström är inte sökbar av karaktären av komprimering algoritm. Tar arkiv ger möjlighet att extrahera arbitrarisk rekord, så det måste driva sökbar ström under locket.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

InvalidDataException

Arkivet är korrupt.

FromXz(Stream)

Extract levereras xz format arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: xz arkiv extraheras helt inom denna metod, dess innehåll hålls intern.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiv ger möjlighet att extrahera vilseledande rekord, så det måste driva sökbar ström under höljet.

FromXz(Sträng)

Extract levereras xz format arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: xz arkiv extraheras helt inom denna metod, dess innehåll hålls intern.

public static TarArchive FromXz(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiv ger möjlighet att extrahera vilseledande rekord, så det måste driva sökbar ström under höljet.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

Från Z(Stream)

Extrakt levereras Z-format arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: Z arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiv ger möjlighet att extrahera vilseledande rekord, så det måste driva sökbar ström under höljet.

Från Z(Sträng)

Extrakt levereras Z-format arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: Z arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromZ(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiv ger möjlighet att extrahera vilseledande rekord, så det måste driva sökbar ström under höljet.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

FromZstandard(Stream)

Extrakt levereras i Zstandard arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: Standard arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Källan till arkivet.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Zstandardström är korrupt eller inte läst.

InvalidDataException

Uppgifterna är korrupta.

FromZstandard(Sträng)

Extrakt levereras i Zstandard arkiv och komponerar Aspose.Zip.Tar.TarArchive från extraherade data.

Viktigt: Standard arkiv extraheras helt inom denna metod, dess innehåll bevaras intern.

public static TarArchive FromZstandard(string path)

Parameters

path string

Vägen till arkivfilen.

Returns

TarArchive

Ett exempel på Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

UnauthorizedAccessException

Tillgång till filen path" vägras.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

NotSupportedException

Filen på path" är i ett invalidformat.

DirectoryNotFoundException

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

FileNotFoundException

Filen hittades inte.

IOException

Zstandardström är korrupt eller inte läst.

InvalidDataException

Uppgifterna är korrupta.

Save(Stream eller TarFormat?)

Spara arkiv till den tillhandahållna strömmen.

public void Save(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

Examples

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Remarks

Måste vara skribar.

Exceptions

ArgumentException

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 och TarFormat?)

Spara arkiv till en avsedd fil som tillhandahålls.

public void Save(string destinationFileName, TarFormat? format = null)

Parameters

destinationFileName string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

Examples

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Remarks

Det är möjligt att spara ett arkiv på samma väg som det laddades från. Detta rekommenderas dock inte eftersom denna metod använder kopiering till en tillfällig fil.

Exceptions

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

PathTooLongException

Den angivna destinationFileName’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna destinationFileName’ är ogiltig (t.ex. den är på en outmappad enhet).

IOException

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

UnauthorizedAccessException

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.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

Filen hittades inte.

SaveGzipped(Stream eller TarFormat?)

Spara arkiv till strömmen med gzip-kompression.

public void SaveGzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Måste vara skribar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(String och TarFormat?)

Spara arkiv till filen per väg med gzip-kompression.

public void SaveGzipped(string path, TarFormat? format = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

SaveLZ4 komprimerad(Stream eller TarFormat?)

Spara arkiv till strömmen med LZ4 kompression.

public void SaveLZ4Compressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Måste vara skribar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4 komprimerad(String och TarFormat?)

Spara arkiv till filen med LZ4 kompression.

public void SaveLZ4Compressed(string path, TarFormat? format = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

Hålls komprimerad(Stream eller TarFormat?)

Spara arkiv till strömmen med LZMA-kompression.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Måste vara skribar.

Viktigt: tar arkiv består sedan komprimeras inom denna metod, dess innehåll hålls intern.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Hålls komprimerad(String och TarFormat?)

Spara arkiv till filen på väg med lzma kompression.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Viktigt: tar arkiv består sedan komprimeras inom denna metod, dess innehåll hålls intern.

Exceptions

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Stream eller TarFormat?)

Spara arkiv till strömmen med lzip-kompression.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Måste vara skribar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(String och TarFormat?)

Spara arkiv till filen på väg med lzip-kompression.

public void SaveLzipped(string path, TarFormat? format = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Spara arkiv till strömmen med xz-kompression.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

settings XzArchiveSettings

Set av specifika xz arkiv inställningar: ordbokstorlek, blockstorlek, kontroll typ.

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 måste vara skribar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(sträng, TarFormat?, XzArchiveSettings)

Spara arkiv till vägen genom vägen med xz-kompression.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

settings XzArchiveSettings

Set av specifika xz arkiv inställningar: ordbokstorlek, blockstorlek, kontroll typ.

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

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

Säkerhetskomprimerad(Stream eller TarFormat?)

Spara arkiv till strömmen med Z-kompression.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Måste vara skribar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Säkerhetskomprimerad(String och TarFormat?)

Spara arkiv till vägen genom vägen med Z-kompression.

public void SaveZCompressed(string path, TarFormat? format = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Stream eller TarFormat?)

Spara arkiv till strömmen med standardkompression.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parameters

output Stream

Destination strömmar.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

Måste vara skribar.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(String och TarFormat?)

Spara arkiv till filen på väg med standardkompression.

public void SaveZstandard(string path, TarFormat? format = null)

Parameters

path string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

format TarFormat ?

Definiera tar headerformat. nollvärde kommer att behandlas som USTar när det är möjligt.

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

UnauthorizedAccessException

Ringaren har inte den nödvändiga tillstånd. -eller- path’ angett en läs-enbart fil eller katalog.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

PathTooLongException

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

DirectoryNotFoundException

Den angivna path’ är ogiltig, (t.ex. den är på en icke-mappad disk).

NotSupportedException

path’ is in an invalid format.

 Svenska