Class TarArchive

Class TarArchive

ja nimityö: Aspose.Zip.Tar Kokoelma: Aspose.Zip.dll (25.5.0)

Tämä luokka edustaa tar arkistotiedostoa. Käytä sitä koota, poistaa tai päivittää tar tiedostoja.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Perintöjäsenet

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

Constructors

TarArchive()

Aloittaa Aspose.Zip.Tar.TarArchive -luokan uusi esimerkki.

public TarArchive()

Examples

Seuraava esimerkki osoittaa, miten tiedostoa puristetaan.

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

TarArchive(Stream)

Aloita uusi esimerkki Aspose.Zip.Archive luokka ja koostuu sisäänkirjailu voidaan poistaa arkistosta.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Arkiston lähde. se on etsimätön.

Examples

Seuraava esimerkki osoittaa, miten poistaa kaikki merkinnät direktoriin.

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

Remarks

Tämä rakentaja ei poista mitään sisäänkäyntiä. Katso Aspose.Zip.Tar.TarEntry.Open menetelmä poista.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(String)

Aloitetaan uusi esimerkki Aspose.Zip.Tar.tarArchive luokka ja koostuu luettelo, joka voidaan poistaa arkistosta.

public TarArchive(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Examples

Seuraava esimerkki osoittaa, miten poistaa kaikki merkinnät direktoriin.

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

Remarks

Tämä rakentaja ei poista mitään sisäänkäyntiä. Katso Aspose.Zip.Tar.TarEntry.Open menetelmä poista.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

FileNotFoundException

Tiedostoa ei löydy.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

IOException

Tiedosto on jo auki.

Properties

Entries

Saat talletuksia Aspose.Zip.Tar.TarEntry -tyypin, joka muodostaa arkiston.

public ReadOnlyCollection<tarentry> Entries { get; }

Omistuksen arvo

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(Pääosat, Bool)

Lisää arkistoon kaikki tiedostot ja luettelot toistuvasti annetussa luettelossa.

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

Parameters

directory DirectoryInfo

Ohjelma on kompressi.

includeRootDirectory bool

Se osoittaa, sisällytetäänkö root-direktiivi itse vai ei.

Returns

TarArchive

Arkisto, jossa on kirjoituksia.

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(Sormus ja bool)

Lisää arkistoon kaikki tiedostot ja luettelot toistuvasti annetussa luettelossa.

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

Parameters

sourceDirectory string

Ohjelma on kompressi.

includeRootDirectory bool

Se osoittaa, sisällytetäänkö root-direktiivi itse vai ei.

Returns

TarArchive

Arkisto, jossa on kirjoituksia.

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

Soittajalle ei ole tarvittavaa lupaa käyttää sourceDirectory'.

ArgumentException

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

PathTooLongException

Tietyt reitit, tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla reitit on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

CreateEntry(virtaa, virtaa, FileSystemInfo)

Luo yksi kirja arkiston sisällä.

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

Parameters

name string

Sisäänkäynnin nimi.

source Stream

Sisäänpääsy virtaa sisäänpääsyyn.

fileInfo FileSystemInfo

Tiedoston tai tiedoston metatiedot tulee kompressoida.

Returns

TarEntry

Sisäänkäynnin tapaus.

Examples

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

Remarks

Sisällön nimi asetetaan vain parametrien sisällä. parametriin annettu tiedoston nimi ei vaikuta sisällön nimiin.

voi viitata System.IO.DirectoryInfo, jos merkintä on luettelo.

Exceptions

PathTooLongException

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

ArgumentException

Tiedoston nimi, osana name’, ylittää 100 symboliä.

CreateEntry(Tietokone, FileInfo ja Bool)

Luo yksi kirja arkiston sisällä.

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

Parameters

name string

Sisäänkäynnin nimi.

fileInfo FileInfo

Tiedoston tai tiedoston metatiedot tulee kompressoida.

openImmediately bool

Totuus, jos avaat tiedoston välittömästi, muuten avaa tiedosto arkiston tallennuksessa.

Returns

TarEntry

Sisäänkäynnin tapaus.

Examples

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

Remarks

Sisällön nimi asetetaan vain parametrien sisällä. parametriin annettu tiedoston nimi ei vaikuta sisällön nimiin.

voi viitata System.IO.DirectoryInfo, jos merkintä on luettelo.

Jos tiedosto avautuu välittömästi parametrien avulla, se estetään, kunnes arkisto poistetaan.

Exceptions

PathTooLongException

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

ArgumentException

Tiedoston nimi, osana name’, ylittää 100 symboliä.

CreateEntry(String, String ja Bool)

Luo yksi kirja arkiston sisällä.

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

Parameters

name string

Sisäänkäynnin nimi.

path string

Matka tiedostoon kompresoida.

openImmediately bool

Totuus, jos avaat tiedoston välittömästi, muuten avaa tiedosto arkiston tallennuksessa.

Returns

TarEntry

Sisäänkäynnin tapaus.

Examples

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

Remarks

Sisällön nimi asetetaan vain parametrien sisällä. parametriin annettu tiedoston nimi ei vaikuta sisällön nimiin.

Jos tiedosto avautuu välittömästi parametrien avulla, se estetään, kunnes arkisto poistetaan.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä. - tai - Tiedoston nimi, osana name’, ylittää 100 symboliä.

UnauthorizedAccessException

Pääsy path” -tiedostoon kielletään.

PathTooLongException

Tietyn path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä. - tai - name’ on liian pitkä tarille IEEE 1003.1-1998 standardin mukaan.

NotSupportedException

path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

DeleteEntry(TarEntry)

Poistaa tietyn ilmoituksen ensimmäinen esiintyminen ilmoitusluettelosta.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Sisäänpäätökset poistetaan luettelosta.

Returns

TarArchive

Arkisto, jossa on sisäänpääsy poistettu.

Examples

Tässä, miten voit poistaa kaikki kirjoitukset lukuun ottamatta viimeistä:

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

DeleteEntry(Sisältää)

Poista sisäänkirjautuminen sisäänkirjautumislistasta indeksiin.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Sisäänpääsyn nolla-pohjainen indeksi poistetaan.

Returns

TarArchive

Arkisto, jossa on sisäänpääsy poistettu.

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

Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.

public void Dispose()

Dispose(Booli)

Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Hallittuja resursseja on käytettävä.

ExtractToDirectory(String)

Poistaa kaikki tiedostot arkistosta annettuun luetteloon.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Matka direktoriin sijoittaa poistettuja tiedostoja.

Examples

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

Remarks

Jos rekisteri ei ole olemassa, se luodaan.

Exceptions

ArgumentNullException

Matka on nolla

PathTooLongException

Tietyt reitit, tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisissa alustoissa reitit on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

SecurityException

Kääntäjällä ei ole tarvittavaa lupaa käyttää olemassa olevaa direktoria.

NotSupportedException

Jos luetteloa ei ole olemassa, reitillä on rintakehän merkki (:) joka ei ole osa ohjaimen merkkiä (“C:”).

ArgumentException

Path on nollan pituinen sarja, joka sisältää vain valkoista tilaa tai sisältää yhden tai useamman epätasaisen merkkin. Voit hakea epätäasaisia merkkejä käyttämällä System.IO.Path.GetInvalidMathChars -menetelmää. - tai - tie on etukäteen määritelty, tai siinä on vain kolumn merkki (:).

IOException

Tiedosto, joka on määritelty reitin mukaan, on tiedosto. - tai - Verkon nimi ei ole tiedossa.

GZipistä(Stream)

Tuotteet toimitetaan gzip arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: gzip arkisto on täysin poimittu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

GZip-rakennusvirta ei ole etsimätön kompressialgoritmin luonteen vuoksi.Tar arkisto tarjoaa mahdollisuuden poistaa mielivaltainen arkisto, joten sen on toimitettava etsimätön virta alapuolella.

Exceptions

InvalidDataException

Arkisto on korruptoitu.

GZipistä(String)

Tuotteet toimitetaan gzip arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: gzip arkisto on täysin poimittu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromGZip(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

GZip-rakennusvirta ei ole etsimätön kompressialgoritmin luonteen vuoksi.Tar arkisto tarjoaa mahdollisuuden poistaa mielivaltainen arkisto, joten sen on toimitettava etsimätön virta alapuolella.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

InvalidDataException

Arkisto on korruptoitu.

LZ4(String)

Tuotteet toimitetaan LZ4 arkisto ja koostuu Aspose.Zip.Tar.tarArchive poistetuista tiedoista.

Tärkeää: LZ4 arkisto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromLZ4(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

LZ4 kaivostoiminta ei ole etsittävä luonnossa kompressialgoritmin. Tar arkisto tarjoaa mahdollisuuden poistaa tahallinen rekisteri, joten sen on toimitettava etsittävää virtaa alhaalla.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Hakijalla ei ole tarvittavaa käyttöoikeutta

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

EndOfStreamException

Tiedosto on liian lyhyt.

InvalidDataException

Tiedostolla on väärä allekirjoitus.

LZ4(Stream)

Tuotteet toimitetaan LZ4 arkisto ja koostuu Aspose.Zip.Tar.tarArchive poistetuista tiedoista.

Tärkeää: LZ4 arkisto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

LZ4 kaivostoiminta ei ole etsittävä luonnossa kompressialgoritmin. Tar arkisto tarjoaa mahdollisuuden poistaa tahallinen rekisteri, joten sen on toimitettava etsittävää virtaa alhaalla.

Exceptions

ArgumentException

Ei voi lukea lähteestä source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

source" on väärä allekirjoitus.

Jäämme(Stream)

Tuotteet toimitetaan LZMA arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: LZMA-tiedosto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

LZMA-lähtövirta ei ole hakeutuva kompressialgoritmin luonnosta. Tar-arkisto tarjoaa mahdollisuuden vetää tahallisesti rekisteriä, joten sen on toimitettava hakeutuva virta kuoren alla.

Exceptions

InvalidDataException

Arkisto on korruptoitu.

Jäämme(String)

Tuotteet toimitetaan LZMA arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: LZMA-tiedosto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromLZMA(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

LZMA-lähtövirta ei ole hakeutuva tiivistelmäalgoritmin luonteen mukaan. Tar arkisto tarjoaa mahdollisuuden vetää tahallisesti rekisteriä, joten sen on toimitettava hakuva virta kuoren alla.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

Zipistä(Stream)

Tuotteet toimitetaan lzip arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: lzip arkisto on täysin poimittu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

Tar arkisto tarjoaa mahdollisuuden poistaa tahallisesti rekisteriä, joten sen on toimitettava hakeutuva virta alhaalla.

Exceptions

InvalidDataException

Arkisto on korruptoitu.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Zipistä(String)

Tuotteet toimitetaan lzip arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: lzip arkisto on täysin poimittu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromLZip(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

Tar arkisto tarjoaa mahdollisuuden poistaa tahallisesti rekisteriä, joten sen on toimitettava hakeutuva virta alhaalla.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

InvalidDataException

Arkisto on korruptoitu.

FromXz(Stream)

Tuotteet toimitetaan xz-formaatin arkistoon ja koostuu Aspose.Zip.Tar.TarArchive poistetuista tiedoista.

Tärkeää: xz arkisto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

Tar arkisto tarjoaa mahdollisuuden poistaa mielivaltainen arkisto, joten sen on toimitettava etsimätön virta alapuolella.

FromXz(String)

Tuotteet toimitetaan xz-formaatin arkistoon ja koostuu Aspose.Zip.Tar.TarArchive poistetuista tiedoista.

Tärkeää: xz arkisto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromXz(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

Tar arkisto tarjoaa mahdollisuuden poistaa mielivaltainen arkisto, joten sen on toimitettava etsimätön virta alapuolella.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

Mistä Z(Stream)

Tuotteet toimitetaan Z-formaatin arkistoon ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: Z arkisto on täysin poimittu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

Tar arkisto tarjoaa mahdollisuuden poistaa mielivaltainen arkisto, joten sen on toimitettava etsimätön virta alapuolella.

Mistä Z(String)

Tuotteet toimitetaan Z-formaatin arkistoon ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: Z arkisto on täysin poimittu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromZ(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Remarks

Tar arkisto tarjoaa mahdollisuuden poistaa mielivaltainen arkisto, joten sen on toimitettava etsimätön virta alapuolella.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

FromZstandard(Stream)

Tuotteet toimitetaan Zstandard arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: Standardi arkisto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Arkiston lähde on.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Säännöllinen virta on korruptoitunut tai lukematon.

InvalidDataException

Tiedot ovat korruptoituneet.

FromZstandard(String)

Tuotteet toimitetaan Zstandard arkisto ja koostuu Aspose.Zip.Tar.TarArchive poistuista tiedoista.

Tärkeää: Standardi arkisto on täysin poistettu tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

public static TarArchive FromZstandard(string path)

Parameters

path string

Tietä arkistoon tiedostoon.

Returns

TarArchive

Esimerkki Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto path" on epätodellisessa muodossa.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

FileNotFoundException

Tiedostoa ei löydy.

IOException

Säännöllinen virta on korruptoitunut tai lukematon.

InvalidDataException

Tiedot ovat korruptoituneet.

Save(Liikenne ja TarFormat?)

Säästää arkistoa tarjottuun virtaukseen.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

Examples

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

Remarks

Pitää olla kirjoitettavaa.

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(Tarformat ja Tarformat?)

Tallenna arkistoa määränpäätiedostoon.

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

Parameters

destinationFileName string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

Examples

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

Remarks

On mahdollista tallentaa arkisto samalle tielle kuin se ladattiin. kuitenkin, tämä ei ole suositeltavaa, koska tämä lähestymistapa käyttää kopiointia tilapäiseen tiedostoon.

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

Määritetty destinationFileName’, tiedoston nimi, tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla reitin on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty destinationFileName’ ei ole pätevä (esimerkiksi se on kartattomalla laitteella).

IOException

Virhe I/O tapahtui tiedoston avaamisen aikana.

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

Tiedostoa ei löydy.

SaveGzipped(Liikenne ja TarFormat?)

Säästä arkistoa virtaan gzip-kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Pitää olla kirjoitettavaa.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Tarformat ja Tarformat?)

Säästää arkiston tiedostoon reitillä gzip-kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

SaveLZ4Kompressi(Liikenne ja TarFormat?)

Säästää arkistoa virtaan LZ4 -kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Pitää olla kirjoitettavaa.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4Kompressi(Tarformat ja Tarformat?)

Säästää arkiston tiedostoon polulla LZ4 -kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

Säästöt kompressit(Liikenne ja TarFormat?)

Säästää arkistoa virtaan LZMA-kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Pitää olla kirjoitettavaa.

Tärkeää: tar arkisto koostuu ja se puristetaan tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Säästöt kompressit(Tarformat ja Tarformat?)

Säästää arkiston tiedostoon polulla lzma-kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Tärkeää: tar arkisto koostuu ja se puristetaan tämän menetelmän sisällä, sen sisältö säilytetään sisäisesti.

Exceptions

UnauthorizedAccessException

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Liikenne ja TarFormat?)

Säästä arkistoa virtaan lzip-kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Pitää olla kirjoitettavaa.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Tarformat ja Tarformat?)

Säästää arkiston tiedostoon polulla lzip-kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Liikenne, TarFormat?, XzArchiveSettings)

Säästä arkistoa virtaan xz-kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

settings XzArchiveSettings

Asetuksen joukko erityinen xz arkisto: sanakirjan koko, lohko koko, tarkistaa tyyppi.

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

Virran on oltava kirjoitettava.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(virta, TarFormat?, XzArchiveSettings)

Säästää arkistoa tielle tiellä xz-kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

settings XzArchiveSettings

Asetuksen joukko erityinen xz arkisto: sanakirjan koko, lohko koko, tarkistaa tyyppi.

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

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

Säädettyä(Liikenne ja TarFormat?)

Säästä arkistoa virtaan Z-kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Pitää olla kirjoitettavaa.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Säädettyä(Tarformat ja Tarformat?)

Säästää arkistoa tielle tiellä Z-kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Liikenne ja TarFormat?)

Säästä arkistoa virtaan Zstandard-kompressiolla.

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

Parameters

output Stream

Tavoitteen virta.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Pitää olla kirjoitettavaa.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Tarformat ja Tarformat?)

Säästää arkiston tiedostoon tiellä Zstandard-kompressiolla.

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

Parameters

path string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

format TarFormat ?

Null-arvoa käsitellään USTarina mahdollisuuksien mukaan.

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

Soittajalla ei ole vaadittua lupaa. -or- path’ määritelty lukematon tiedosto tai luettelo.

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

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

DirectoryNotFoundException

Määritetty path’ on pätevä, (esimerkiksi se on kartattoman ajoneuvon päällä).

NotSupportedException

path’ is in an invalid format.

 Suomi