Class TarArchive

Class TarArchive

Navne til: Aspose.Zip.Tar Sammensætning: Aspose.Zip.dll (25.5.0)

Denne klasse repræsenterer en tar arkivfil. Brug det til at komponere, udveksle eller opdatere tar-arkiver.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

De arvede medlemmer

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

Constructors

TarArchive()

Det initierer en ny instans af Aspose.Zip.Tar.TarArchive klasse.

public TarArchive()

Examples

Følgende eksempel viser, hvordan man komprimerer en fil.

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

TarArchive(Stream)

Initialiserer en ny instans af Aspose.Zip.Archive-klassen og komponerer en indgangsliste, der kan uddrages fra arkivet.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Arkivets kilde. det skal være søgbart.

Examples

Følgende eksempel viser, hvordan man ekstrakter alle indtægter til en katalog.

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

Remarks

Denne konstruktør fjerner ingen indtægter. Se Aspose.Zip.Tar.TarEntry.Open metode for fjerner.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(String)

Initialiserer en ny instans af Aspose.Zip.Tar.tarArchive klasse og udgør en indgangsliste, der kan udvundes fra arkivet.

public TarArchive(string path)

Parameters

path string

Vejen til arkiveret.

Examples

Følgende eksempel viser, hvordan man ekstrakter alle indtægter til en katalog.

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

Remarks

Denne konstruktør fjerner ingen indtægter. Se Aspose.Zip.Tar.TarEntry.Open metode for fjerner.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

FileNotFoundException

Filen er ikke fundet.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

Properties

Entries

Få indtægter af Aspose.Zip.Tar.TarEntry type, der udgør arkivet.

public ReadOnlyCollection<tarentry> Entries { get; }

Ejendomsværdi

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(Anmeldelse: Bool)

Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.

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

Parameters

directory DirectoryInfo

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

Returns

TarArchive

arkiver med indtægter sammensat.

Examples

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

CreateEntries(String og Bool)

Adder til arkivet alle filer og kataloger gentagne gange i den angivne katalog.

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

Parameters

sourceDirectory string

Direktorer til komprimering.

includeRootDirectory bool

Indikerer, om man skal inkludere selve roddokumentet eller ej.

Returns

TarArchive

arkiver med indtægter sammensat.

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

Ringeren har ikke den nødvendige tilladelse til at få adgang til sourceDirectory'.

ArgumentException

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

PathTooLongException

Den angivne vej, filnavn, eller begge overskrider den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal vejene være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. Den angivne vej, filnavn, eller begge er for lange.

CreateEntry(String, Stream og FileSystemInfo)

Skab en enkelt indgang i arkivet.

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

Parameters

name string

Navnet på indgangen.

source Stream

Indtægtsstrøm for indtægten.

fileInfo FileSystemInfo

Metadata af filen eller mappen skal komprimeres.

Returns

TarEntry

Indtastning af indtastning af indtastning.

Examples

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

Remarks

Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.

kan henvise til System.IO.DirectoryInfo, hvis indtægten er katalog.

Exceptions

PathTooLongException

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

ArgumentException

Filnavnet, som en del af name’, overstiger 100 symboler.

CreateEntry(String, FileInfo og Bool)

Skab en enkelt indgang i arkivet.

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

Parameters

name string

Navnet på indgangen.

fileInfo FileInfo

Metadata af filen eller mappen skal komprimeres.

openImmediately bool

Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.

Returns

TarEntry

Indtastning af indtastning af indtastning.

Examples

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

Remarks

Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.

kan henvise til System.IO.DirectoryInfo, hvis indtægten er katalog.

Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.

Exceptions

PathTooLongException

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

ArgumentException

Filnavnet, som en del af name’, overstiger 100 symboler.

CreateEntry(String, String og Bool)

Skab en enkelt indgang i arkivet.

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

Parameters

name string

Navnet på indgangen.

path string

Vejen til fil at blive komprimeret.

openImmediately bool

Sannelig, hvis du åbner filen umiddelbart, ellers åbner du filen på arkivering.

Returns

TarEntry

Indtastning af indtastning af indtastning.

Examples

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

Remarks

Indtægtsnavnet er kun indstillet inden for parameter. filnavnet angivet i parameter påvirker ikke indtægtsnavnet.

Hvis filen åbnes umiddelbart med parameteren, blokeres den, indtil arkivet slettes.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn. - eller - Filnavnet, som en del af name’, overstiger 100 symboler.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme, må veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn. - eller - name’ er for lang til tar i forhold til IEEE 1003.1-1998 standard.

NotSupportedException

Filen på path’ indeholder en kolonne (:) i midten af ringen.

DeleteEntry(TarEntry)

Det fjerner den første forekomst af en bestemt indtastning fra indtastningslisten.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Indtægten skal fjernes fra listen over indtægter.

Returns

TarArchive

Arkivet med indgangen er slettet.

Examples

Her er, hvordan du kan fjerne alle indtægter undtagen den sidste:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(Int)

Fjern indtægten fra indtægtslisten ved indeks.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Det nulbaserede indeks af indtægten skal fjernes.

Returns

TarArchive

Arkivet med indgangen er slettet.

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

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

Dispose(Bool)

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Om de forvaltede ressourcer skal fjernes.

ExtractToDirectory(String)

Udveksler alle filer i arkivet til den leverede katalog.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Vejen til katalogen til at placere de udvundne filer i.

Examples

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

Remarks

Hvis katalogen ikke eksisterer, vil den blive oprettet.

Exceptions

ArgumentNullException

Vejen er null

PathTooLongException

Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.

SecurityException

Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.

NotSupportedException

Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“C:”).

ArgumentException

Path er en nulllængde string, indeholder kun hvid plads, eller indeholder en eller flere invalide tegn. Du kan spørge for invalid tegn ved hjælp af System.IO.Path.GetInvalidFathChars metode. - eller - vej er forhåndsbestemt med eller indeholder kun en kolon karakter (:).

IOException

Den katalog, der er angivet af vejen, er en fil. - eller - Netværksnavnet er ikke kendt.

af Zip(Stream)

Ekstrakter leveret gzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: gzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

GZip ekstraktionsstrøm kan ikke søges af komprimeringsalgoritmens natur.Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.

Exceptions

InvalidDataException

Arkiverne er korrupte.

af Zip(String)

Ekstrakter leveret gzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: gzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromGZip(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

GZip ekstraktionsstrøm kan ikke søges af komprimeringsalgoritmens natur.Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

InvalidDataException

Arkiverne er korrupte.

af LZ4(String)

Ekstrakter leveret LZ4 arkiv og komponerer Aspose.Zip.Tar.tarArchive fra udvundet data.

Vigtigt: LZ4 arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromLZ4(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

LZ4 ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har til at operere søgbare strømme under hoden.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Anmelderen har ikke den nødvendige tilladelse til at få adgang

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

EndOfStreamException

Filen er for kort.

InvalidDataException

Filen har den forkerte underskrift.

af LZ4(Stream)

Ekstrakter leveret LZ4 arkiv og komponerer Aspose.Zip.Tar.tarArchive fra udvundet data.

Vigtigt: LZ4 arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

LZ4 ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har til at operere søgbare strømme under hoden.

Exceptions

ArgumentException

Kan ikke læses fra source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

source’ har den forkerte underskrift.

af LZMA(Stream)

Ekstrakter leveret LZMA arkiver og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: LZMA arkiver er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

LZMA ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det skal operere søgbart strøm under hoden.

Exceptions

InvalidDataException

Arkiverne er korrupte.

af LZMA(String)

Ekstrakter leveret LZMA arkiver og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: LZMA arkiver er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromLZMA(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

LZMA ekstraktionsstrøm er ikke søgbart af karakteren af komprimeringsalgoritmen. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har til at operere søgbare strømme under hoden.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

af Zip(Stream)

Ekstrakter leveret lzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: lzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

Lzip ekstraktionsstrøm er ikke søgbart af natur af komprimering algoritme. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har at operere søgbart strøm under hoden.

Exceptions

InvalidDataException

Arkiverne er korrupte.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

af Zip(String)

Ekstrakter leveret lzip arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: lzip arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromLZip(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

Lzip ekstraktionsstrøm er ikke søgbart af natur af komprimering algoritme. Tar arkiv giver mulighed for at udveksle vilkårlig rekord, så det har at operere søgbart strøm under hoden.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

InvalidDataException

Arkiverne er korrupte.

FromXz(Stream)

Ekstrakter leveret xz format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: xz arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.

FromXz(String)

Ekstrakter leveret xz format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: xz arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromXz(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

Fra Z(Stream)

Ekstrakter leveret Z-format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra de udvundne data.

Vigtigt: Z arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.

Fra Z(String)

Ekstrakter leveret Z-format arkiv og komponerer Aspose.Zip.Tar.TarArchive fra de udvundne data.

Vigtigt: Z arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromZ(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Remarks

Tar arkiver giver mulighed for at udveksle vilkårlig optegnelse, så det har til at operere søgende strøm under hoden.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

FromZstandard(Stream)

Ekstrakter leveret Zstandard arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: Standard arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

kilden til arkivet.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Den almindelige strøm er korrumperet eller ikke læses.

InvalidDataException

Data er korrupte.

FromZstandard(String)

Ekstrakter leveret Zstandard arkiv og komponerer Aspose.Zip.Tar.TarArchive fra udvundet data.

Vigtigt: Standard arkiv er fuldt ud udvundet inden for denne metode, dens indhold bevares internalt.

public static TarArchive FromZstandard(string path)

Parameters

path string

Vejen til arkiveret.

Returns

TarArchive

Et eksempel på Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

UnauthorizedAccessException

Tilgang til filen path’ er nægtet.

PathTooLongException

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

NotSupportedException

Filen på path’ er i et ugyldigt format.

DirectoryNotFoundException

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

FileNotFoundException

Filen er ikke fundet.

IOException

Den almindelige strøm er korrumperet eller ikke læses.

InvalidDataException

Data er korrupte.

Save(Strøm eller TarFormat?)

Sparer arkiver til den leverede strøm.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

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

Remarks

Det skal være skriftligt.

Exceptions

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

Sparer arkiver til en bestemmelsesfil, der er leveret.

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

Parameters

destinationFileName string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

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

Remarks

Det er muligt at gemme et arkiv på samme vej, som det blev lastet fra. dog anbefales dette ikke, fordi denne tilgang bruger kopiering til en midlertidig fil.

Exceptions

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 angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne destinationFileName’ er ugyldig (f.eks. den er på en ikke-mapped disk).

IOException

En I/O-fejl opstod under åbningen af 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 er ikke fundet.

SaveGzipped(Strøm eller TarFormat?)

Sparer arkiver til strømmen med gzip-kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

Remarks

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(String og TarFormat?)

Sparer arkiver til filen ved hjælp af gzip-kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

L4 komprimeret(Strøm eller TarFormat?)

Sparer arkiver til strømen med LZ4 kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz4"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZ4Compressed(result);
        }
    }
}

Remarks

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

L4 komprimeret(String og TarFormat?)

Sparer arkiver til filen ved hjælp af LZ4 kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZ4Compressed("result.tar.lz4");
    }
}

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

Sikkerhed komprimeret(Strøm eller TarFormat?)

Sparer arkiver til strømen med LZMA-kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

Remarks

Det skal være skriftligt.

Vigtigt: tar arkiver er sammensat og komprimeret inden for denne metode, dens indhold bevares internalt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Sikkerhed komprimeret(String og TarFormat?)

Sparer arkiver til filen ved hjælp af lzma kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

Remarks

Vigtigt: tar arkiver er sammensat og komprimeret inden for denne metode, dens indhold bevares internalt.

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Strøm eller TarFormat?)

Sparer arkiver til strømen med lzip-kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

Remarks

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(String og TarFormat?)

Sparer arkiver til filen ved hjælp af lzip-kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Strøm, TarFormat?, XzArchiveSettings)

Sparer arkiver til strømen med xz-kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

settings XzArchiveSettings

Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.

Examples

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

Remarks

Strømmen skal være skriftlig.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(String, TarFormat?, XzArchiveSettings)

Sparer arkiver til vejen ved vejen med xz kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

settings XzArchiveSettings

Set af indstillinger specifikt xz arkiv: ordforrådstørrelse, blokstørrelse, check type.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

Beskyttelse komprimeret(Strøm eller TarFormat?)

Sparer arkiver til strømen med Z-kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

Remarks

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Beskyttelse komprimeret(String og TarFormat?)

Sparer arkiver til vejen ved vejen med Z-kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Strøm eller TarFormat?)

Sparer arkiver til strømen med Zstandard kompression.

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

Parameters

output Stream

Destinationstrøm.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

Remarks

Det skal være skriftligt.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(String og TarFormat?)

Sparer arkiver til filen efter vej med Zstandard kompression.

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

Parameters

path string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

format TarFormat ?

Null værdi vil blive behandlet som USTar, når det er muligt.

Examples

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}

Exceptions

UnauthorizedAccessException

Ringeren har ikke den krævede tilladelse. -eller- path’ angivet en læst alene 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 angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

DirectoryNotFoundException

Den angivne path’ er ugyldig (f.eks. den er på en ikke-mapped disk).

NotSupportedException

path’ is in an invalid format.

 Dansk