Class TarArchive

Class TarArchive

De naam: Aspose.Zip.Tar Verzameling: Aspose.Zip.dll (25.5.0)

Deze klasse vertegenwoordigt een tar archiefbestand. Gebruik het om te composeren, extraheren of updaten van tar-archieven.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Geëerbiede leden

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

Constructors

TarArchive()

Het initiërt een nieuwe instantie van de Aspose.Zip.Tar.TarArchive klasse.

public TarArchive()

Examples

Het volgende voorbeeld laat zien hoe u een bestand kunt compresseren.

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

TarArchive(Stream)

Initialiseert een nieuwe instantie van de Aspose.Zip.Archive-klasse en maakt een inlijstlijst die uit het archief kan worden geïntroduceerd.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

De bron van het archief. het moet zoeken.

Examples

Het volgende voorbeeld laat zien hoe u alle inzichten in een directory kunt extraheren.

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

Remarks

Deze constructor verwijdert geen ingang. zie Aspose.Zip.Tar.TarEntry.Open methode voor verwijdering.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(String)

Initialiseert een nieuwe instantie van de Aspose.Zip.Tar.tarArchive-klasse en maakt een inganglijst die kan worden geïntroduceerd uit het archief.

public TarArchive(string path)

Parameters

path string

De weg naar het archiefbestand.

Examples

Het volgende voorbeeld laat zien hoe u alle inzichten in een directory kunt extraheren.

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

Remarks

Deze constructor verwijdert geen ingang. zie Aspose.Zip.Tar.TarEntry.Open methode voor verwijdering.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ bevat een kolom (:) in het midden van de string.

FileNotFoundException

Het bestand is niet gevonden.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

IOException

Het bestand is al open.

Properties

Entries

Geeft input van Aspose.Zip.Tar.TarEntry type die het archief vormt.

public ReadOnlyCollection<tarentry> Entries { get; }

Eigendomswaarde

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(DirectoryInfo, Bool)

Toegevoegd aan het archief alle bestanden en directories herhaaldelijk in de gegeven directory.

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

Parameters

directory DirectoryInfo

Directory voor compressie.

includeRootDirectory bool

Hiermee wordt aangegeven of de root directory zelf moet worden opgenomen of niet.

Returns

TarArchive

Het archief met ingeschreven inzichten.

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 en Bool)

Toegevoegd aan het archief alle bestanden en directories herhaaldelijk in de gegeven directory.

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

Parameters

sourceDirectory string

Directory voor compressie.

includeRootDirectory bool

Hiermee wordt aangegeven of de root directory zelf moet worden opgenomen of niet.

Returns

TarArchive

Het archief met ingeschreven inzichten.

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

De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot sourceDirectory'.

ArgumentException

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

PathTooLongException

De aangegeven pad, bestandnaam, of beide overschrijden de systeemdefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, paden moeten minder dan 248 tekens, en bestandnamen moeten minder dan 260 tekens.

CreateEntry(String, Stream en FileSystemInfo)

Creëren van een enkele ingang binnen het archief.

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

Parameters

name string

De naam van de ingang.

source Stream

De ingangstromen voor de ingang.

fileInfo FileSystemInfo

De metadata van het bestand of de map om te worden gecomprimeerd.

Returns

TarEntry

Inleiding van de instantie.

Examples

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

Remarks

De invoernaam is uitsluitend ingesteld binnen de parameter.De in de parameter verstrekte bestandnaam beïnvloedt de invoernaam niet.

kan verwijzen naar System.IO.DirectoryInfo als de ingang een directory is.

Exceptions

PathTooLongException

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

ArgumentException

De naam van het bestand, als onderdeel van de name’, overschrijdt 100 symbolen.

CreateEntry(String, FileInfo en Bool)

Creëren van een enkele ingang binnen het archief.

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

Parameters

name string

De naam van de ingang.

fileInfo FileInfo

De metadata van het bestand of de map om te worden gecomprimeerd.

openImmediately bool

Het is waar, als u het bestand onmiddellijk opent, anders opent u het bestand op archiefopslag.

Returns

TarEntry

Inleiding van de instantie.

Examples

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

Remarks

De invoernaam is uitsluitend ingesteld binnen de parameter.De in de parameter verstrekte bestandnaam beïnvloedt de invoernaam niet.

kan verwijzen naar System.IO.DirectoryInfo als de ingang een directory is.

Als het bestand onmiddellijk wordt geopend met de parameter wordt het geblokkeerd totdat het archief is verwijderd.

Exceptions

PathTooLongException

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

ArgumentException

De naam van het bestand, als onderdeel van de name’, overschrijdt 100 symbolen.

CreateEntry(String, String en Bool)

Creëren van een enkele ingang binnen het archief.

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

Parameters

name string

De naam van de ingang.

path string

De weg naar het bestanden om gecomprimeerd te worden.

openImmediately bool

Het is waar, als u het bestand onmiddellijk opent, anders opent u het bestand op archiefopslag.

Returns

TarEntry

Inleiding van de instantie.

Examples

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

Remarks

De invoernaam is uitsluitend ingesteld binnen de parameter.De in de parameter verstrekte bestandnaam beïnvloedt de invoernaam niet.

Als het bestand onmiddellijk wordt geopend met de parameter wordt het geblokkeerd totdat het archief is verwijderd.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes, of bevat ongeldig tekens. - of - File name, als onderdeel van name’, overschrijdt 100 symbolen.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens zijn en bestandnamen moeten minder dan 260 tekens zijn. - of - name’ is te lang voor tar dan van de IEEE 1003.1-1998 standaard.

NotSupportedException

Het bestand op path’ bevat een kolom (:) in het midden van de string.

DeleteEntry(TarEntry)

Verwijder de eerste verschijning van een specifieke ingang uit de inganglijst.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

De ingang om te verwijderen uit de inganglijst.

Returns

TarArchive

Het archief met de ingang is verwijderd.

Examples

Hier is hoe u alle inschrijvingen kunt verwijderen met uitzondering van de laatste:

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

DeleteEntry(Int)

Verwijder de ingang van de inganglijst door index.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

De nulgebaseerde index van de ingang te verwijderen.

Returns

TarArchive

Het archief met de ingang is verwijderd.

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

Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.

public void Dispose()

Dispose(Bool)

Het vervult toepasselijk gedefinieerde taken die verband houden met het vrijgeven, vrijgeven of herstructureren van onbeheerde middelen.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Of de beheerde middelen moeten worden afgebroken.

ExtractToDirectory(String)

Extract alle bestanden in het archief naar het verstrekte directory.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

De route naar het directory om de geïntroduceerde bestanden in te plaatsen.

Examples

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

Remarks

Als de directory niet bestaat, wordt deze gemaakt.

Exceptions

ArgumentNullException

De weg is nul

PathTooLongException

De aangegeven pad, bestandnaam of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms moeten paden minder dan 248 tekens en bestandnamen moeten minder dan 260 tekens zijn.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen tot de bestaande directory.

NotSupportedException

Als de directory niet bestaat, bevat de route een colon karakter (:) dat niet deel uitmaakt van een drive label (“C:”).

ArgumentException

Path is een nullengte string, bevat alleen witte ruimte, of bevat één of meer invalide tekens. U kunt vragen voor invalde tekenen door gebruik te maken van de System.IO.Path.GetInvalidMathChars methode. - of - pad is vooraf vastgesteld met, or bevat, slechts een colon karakter (:).

IOException

De door de route aangegeven directory is een bestand. - of - De naam van het netwerk is niet bekend.

van GZIP(Stream)

Extract geleverd gzip archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: gzip archief wordt volledig in deze methode geëxtraheerd, zijn inhoud wordt intern bewaard.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

GZip extractie stroom is niet te zoeken door de aard van de compressie algoritme.Tar archief biedt de mogelijkheid om arbitraire records te extraheren, dus het moet de zoektochtbare stroom onder de hood opereren.

Exceptions

InvalidDataException

Het archief is corrupt.

van GZIP(String)

Extract geleverd gzip archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: gzip archief wordt volledig in deze methode geëxtraheerd, zijn inhoud wordt intern bewaard.

public static TarArchive FromGZip(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

GZip extractie stroom is niet te zoeken door de aard van de compressie algoritme.Tar archief biedt de mogelijkheid om arbitraire records te extraheren, dus het moet de zoektochtbare stroom onder de hood opereren.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

InvalidDataException

Het archief is corrupt.

van LZ4(String)

Extract geleverd LZ4 archief en composeert Aspose.Zip.tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: LZ4 archief is volledig in deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromLZ4(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

LZ4 extractie stroom is niet te zoeken door de aard van de compressie algoritme. Tar archief biedt de mogelijkheid om willekeurige record te extraheren, dus het moet de zoektochtstromen onder de hood opereren.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

De oproepgever heeft niet de vereiste toestemming om toegang te krijgen

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

EndOfStreamException

Het bestand is te kort.

InvalidDataException

Het bestand heeft de verkeerde handtekening.

van LZ4(Stream)

Extract geleverd LZ4 archief en composeert Aspose.Zip.tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: LZ4 archief is volledig in deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

LZ4 extractie stroom is niet te zoeken door de aard van de compressie algoritme. Tar archief biedt de mogelijkheid om willekeurige record te extraheren, dus het moet de zoektochtstromen onder de hood opereren.

Exceptions

ArgumentException

Niet te lezen van bron’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

De bron’ heeft de verkeerde handtekening.

van LZMA(Stream)

Extract geleverd LZMA archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: LZMA archief is volledig in deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

LZMA extractie stroom is niet te zoeken door de aard van de compressie algoritme. Tar archief biedt de mogelijkheid om willekeurige record te extraheren, dus het moet de zoektocht stroom onder de hood te beheren.

Exceptions

InvalidDataException

Het archief is corrupt.

van LZMA(String)

Extract geleverd LZMA archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: LZMA archief is volledig in deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromLZMA(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

LZMA extractie stroom is niet te zoeken door de aard van de compressie algoritme. Tar archief biedt de mogelijkheid om willekeurige record te extraheren, dus het moet de zoektocht streom onder de hood opereren.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

van LZIP(Stream)

Extract geleverd lzip archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: lzip archief wordt volledig geëxtraheerd binnen deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

Lzip extractie stroom is niet te zoeken door de aard van de compressie algoritme. Tar archief biedt de mogelijkheid om willekeurige record te extraheren, dus het moet de zoektocht stroom onder de hood te beheren.

Exceptions

InvalidDataException

Het archief is corrupt.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

van LZIP(String)

Extract geleverd lzip archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: lzip archief wordt volledig geëxtraheerd binnen deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromLZip(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

Lzip extractie stroom is niet te zoeken door de aard van de compressie algoritme. Tar archief biedt de mogelijkheid om willekeurige record te extraheren, dus het moet de zoektocht stroom onder de hood te beheren.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

InvalidDataException

Het archief is corrupt.

FromXz(Stream)

Extract geleverd xz-formaat archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: xz archief wordt volledig in deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

Tar archief biedt de mogelijkheid om arbitraire records te extraheren, dus het moet de zoektochtbare stroom onder de hood opereren.

FromXz(String)

Extract geleverd xz-formaat archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: xz archief wordt volledig in deze methode, zijn inhoud wordt intern bewaard.

public static TarArchive FromXz(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

Tar archief biedt de mogelijkheid om arbitraire records te extraheren, dus het moet de zoektochtbare stroom onder de hood opereren.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

van Z(Stream)

Extract geleverd Z-formaat archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: Z archief wordt volledig in deze methode geëxtraheerd, zijn inhoud wordt intern bewaard.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

Tar archief biedt de mogelijkheid om arbitraire records te extraheren, dus het moet de zoektochtbare stroom onder de hood opereren.

van Z(String)

Extract geleverd Z-formaat archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: Z archief wordt volledig in deze methode geëxtraheerd, zijn inhoud wordt intern bewaard.

public static TarArchive FromZ(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Remarks

Tar archief biedt de mogelijkheid om arbitraire records te extraheren, dus het moet de zoektochtbare stroom onder de hood opereren.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

FromZstandard(Stream)

Extract geleverd Zstandard archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: Zstandard archief wordt volledig in deze methode geëxtraheerd, zijn inhoud wordt intern bewaard.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

De bron van het archief.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Zstandard stroom is corrupt of niet leesbaar.

InvalidDataException

De gegevens zijn corrupt.

FromZstandard(String)

Extract geleverd Zstandard archief en composeert Aspose.Zip.Tar.TarArchive uit geïntroduceerde gegevens.

Belangrijk: Zstandard archief wordt volledig in deze methode geëxtraheerd, zijn inhoud wordt intern bewaard.

public static TarArchive FromZstandard(string path)

Parameters

path string

De weg naar het archiefbestand.

Returns

TarArchive

Een voorbeeld van Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.

UnauthorizedAccessException

De toegang tot het bestand path’ wordt geweigerd.

PathTooLongException

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

NotSupportedException

Het bestand op path’ is in een ongeldig formaat.

DirectoryNotFoundException

De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.

FileNotFoundException

Het bestand is niet gevonden.

IOException

Zstandard stroom is corrupt of niet leesbaar.

InvalidDataException

De gegevens zijn corrupt.

Save(Stream of TarFormat?)

Speel archief op de geleverde stroom.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

Examples

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

Remarks

moet geschreven zijn.

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

Speel archief op een bestand van bestemming.

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

Parameters

destinationFileName string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

Examples

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

Remarks

Het is mogelijk om een archief op te slaan op dezelfde route als het is geladen van. echter, dit is niet aanbevolen omdat deze benadering gebruikt het kopiëren naar een tijdelijke bestand.

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

De aangegeven destinationFileName’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven destinationFileName’ is invalid, (bijvoorbeeld, het is op een niet-mapped schijf).

IOException

Een I/O-fout vond plaats tijdens het openen van het bestand.

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

Het bestand is niet gevonden.

SaveGzipped(Stream of TarFormat?)

Save archief naar de stroom met gzip compressie.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

moet geschreven zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(String en TarFormat?)

Speelt archief naar het bestand per pad met gzip compressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

SaveLZ4 gecomprimeerd(Stream of TarFormat?)

Save archief naar de stroom met LZ4 compressie.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

moet geschreven zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4 gecomprimeerd(String en TarFormat?)

Speelt archief naar de bestand per pad met LZ4 compressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

SaveLZMACcompressie(Stream of TarFormat?)

Save archief naar de stroom met LZMA compressie.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

moet geschreven zijn.

Belangrijk: tar archief wordt samengesteld en vervolgens gecomprimeerd binnen deze methode, zijn inhoud wordt intern bewaard.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZMACcompressie(String en TarFormat?)

Speelt archief naar het bestand per pad met lzma compressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

Belangrijk: tar archief wordt samengesteld en vervolgens gecomprimeerd binnen deze methode, zijn inhoud wordt intern bewaard.

Exceptions

UnauthorizedAccessException

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Stream of TarFormat?)

Save archief naar de stroom met lzip compression.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

moet geschreven zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(String en TarFormat?)

Speelt archief naar het bestand per pad met lzip compressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Save archief naar de stroom met xz compressie.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

settings XzArchiveSettings

Set van specifieke xz archief instellingen: woordenboekgrootte, blokgrootte, 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

De stroom moet geschreven zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Save archief naar de route per route met xz compressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

settings XzArchiveSettings

Set van specifieke xz archief instellingen: woordenboekgrootte, blokgrootte, 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

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

SaveZCompressie(Stream of TarFormat?)

Spar archief naar de stroom met Z-compressie.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

moet geschreven zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZCompressie(String en TarFormat?)

Speelt archief naar de route door de route met Z-compressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Stream of TarFormat?)

Speel archief op de stroom met een standaardcompressie.

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

Parameters

output Stream

De bestemming stroom.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

moet geschreven zijn.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(String en TarFormat?)

Speelt archief naar het bestand per pad met standaardcompressie.

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

Parameters

path string

De route van het archief om te worden gecreëerd.Als de aangegeven bestandnaam wijst op een bestaande bestand, wordt het overgeschreven.

format TarFormat ?

Definieert het tar headerformaat. null waarde zal als USTar worden behandeld wanneer mogelijk.

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

De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.

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

De aangegeven path’, bestandsnaam, of beide overschrijden de door het systeem gedefinieerde maximale lengte. Bijvoorbeeld, op Windows-gebaseerde platforms, moeten paden minder dan 248 tekens zijn, en bestandsnamen moeten minder dan 260 tekens zijn.

DirectoryNotFoundException

De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).

NotSupportedException

path’ is in an invalid format.

 Nederlands