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
Implements
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
sourceStream’ is not seekable.
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
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ bevat een kolom (:) in het midden van de string.
Het bestand is niet gevonden.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
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
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
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
sourceDirectory’ is null.
De oproeker heeft niet de vereiste toestemming om toegang te krijgen tot sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen.
De path’ is leeg, bevat alleen witte ruimtes, of bevat ongeldig tekens. - of - File name, als onderdeel van
name’, overschrijdt 100 symbolen.
De toegang tot het bestand path’ wordt geweigerd.
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.
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
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 > 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
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
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
De weg is nul
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.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen tot de bestaande directory.
Als de directory niet bestaat, bevat de route een colon karakter (:) dat niet deel uitmaakt van een drive label (“C:”).
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 (:).
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
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
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
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
path’ is null.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is niet gevonden.
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
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
path’ is null.
De oproepgever heeft niet de vereiste toestemming om toegang te krijgen
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is niet gevonden.
Het bestand is te kort.
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
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
Niet te lezen van bron’
source’ is null.
source’ is too short.
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
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
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
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
path’ is null.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
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
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
Het archief is corrupt.
source’ is not seekable.
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
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
path’ is null.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is niet gevonden.
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
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
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
path’ is null.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
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
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
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
path’ is null.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
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
Een voorbeeld van Aspose.Zip.Tar.TarArchive
Exceptions
Zstandard stroom is corrupt of niet leesbaar.
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
Een voorbeeld van Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
De path’ is leeg, bevat alleen witte ruimtes of bevat invalide tekens.
De toegang tot het bestand path’ wordt geweigerd.
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.
Het bestand op path’ is in een ongeldig formaat.
De aangegeven route is ongeldig, bijvoorbeeld op een onmapped drive.
Het bestand is niet gevonden.
Zstandard stroom is corrupt of niet leesbaar.
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
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
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
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.
De aangegeven destinationFileName’ is invalid, (bijvoorbeeld, het is op een niet-mapped schijf).
Een I/O-fout vond plaats tijdens het openen van het bestand.
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.
destinationFileName’ is in an invalid format.
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
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
output’ is null.
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
De oproepgever heeft niet de vereiste toestemming. -of- path’ aangegeven een alleen leesbestand of directory.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
De aangegeven path’ is ongeldig, (bijvoorbeeld, het is op een onmapped schijf).
path’ is in an invalid format.