Class TarArchive

Class TarArchive

Името на пространството: Aspose.Zip.Tar Асамблея: Aspose.Zip.dll (25.5.0)

Този клас представлява файл за архивиране на тари. Използвайте го, за да съставите, извлечете или актуализирате архивите за таре.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

наследници

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

Constructors

TarArchive()

Aspose.Zip.Tar.TarArchive.

public TarArchive()

Examples

Следващият пример показва как да компресирате файл.

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

TarArchive(Stream)

Иницијализира нова инстанция на Aspose.Zip.Archive клас и съставя списък с вход, който може да бъде извлечен от архива.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

Източникът на архива. тя трябва да бъде търсена.

Examples

Следващият пример показва как да се извлекат всички записи в директория.

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

Remarks

Този конструктор не отпакова никакви вноски. виж Aspose.Zip.Tar. TarEntry.Open метод за депаковане.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Стрий)

Иницијализира нова инстанция на Aspose.Zip.Tar.Archive клас и съставя списък с вход, който може да бъде извлечен от архива.

public TarArchive(string path)

Parameters

path string

Пътят към архивите.

Examples

Следващият пример показва как да се извлекат всички записи в директория.

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

Remarks

Този конструктор не отпакова никакви вноски. виж Aspose.Zip.Tar. TarEntry.Open метод за депаковане.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Призователят няма изискваното разрешение за достъп.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

code class=“paramref”>path.

FileNotFoundException

Документът не е намерен.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

IOException

Филмът вече е отворен.

Properties

Entries

Aspose.Zip.Tar.TarEntry.

public ReadOnlyCollection<tarentry> Entries { get; }

стойност на имота

ReadOnlyCollection < TarEntry >

Methods

CreateEntries(Директива, Bool)

Добавете към архива всички файлове и директории отново и отново в дадена директория.

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

Parameters

directory DirectoryInfo

Директор за компресиране.

includeRootDirectory bool

Показва дали да се включи самата коренна директория или не.

Returns

TarArchive

Архивът е съставен с вход.

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(Стрелец, Боул)

Добавете към архива всички файлове и директории отново и отново в дадена директория.

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

Parameters

sourceDirectory string

Директор за компресиране.

includeRootDirectory bool

Показва дали да се включи самата коренна директория или не.

Returns

TarArchive

Архивът е съставен с вход.

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

code class=“paramref”>sourceDirectory'.

ArgumentException

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

PathTooLongException

Windows, пътеките трябва да са по-малко от 248 знака, а имената на файловете трябва да са по-малко от 260.

CreateEntry(Стрий, Стрий, FileSystemInfo)

Създаване на един вход в архива.

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

Parameters

name string

Името на входа.

source Stream

Входният поток за входа.

fileInfo FileSystemInfo

метаданните на файла или папката, които трябва да бъдат компресирани.

Returns

TarEntry

Инстанция за влизане.

Examples

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

Remarks

Името на файла, предоставено в параметър, не засяга името на входа.

Можете да се позовавате на System.IO.DirectoryInfo, ако входът е директория.

Exceptions

PathTooLongException

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

ArgumentException

code class=“paramref”>name’, надвишава 100.

CreateEntry(Стъпка, FileInfo, Bool)

Създаване на един вход в архива.

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

Parameters

name string

Името на входа.

fileInfo FileInfo

метаданните на файла или папката, които трябва да бъдат компресирани.

openImmediately bool

Вярно е, че ако отворите файла веднага, в противен случай отворете файлът на архива.

Returns

TarEntry

Инстанция за влизане.

Examples

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

Remarks

Името на файла, предоставено в параметър, не засяга името на входа.

Можете да се позовавате на System.IO.DirectoryInfo, ако входът е директория.

Ако файлът се отваря незабавно с параметър, той се блокира, докато архивите не бъдат изтрити.

Exceptions

PathTooLongException

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

ArgumentException

code class=“paramref”>name’, надвишава 100.

CreateEntry(Стринг, Стринг и Боол)

Създаване на един вход в архива.

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

Parameters

name string

Името на входа.

path string

Пътят към файла да бъде компресиран.

openImmediately bool

Вярно е, че ако отворите файла веднага, в противен случай отворете файлът на архива.

Returns

TarEntry

Инстанция за влизане.

Examples

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

Remarks

Името на файла, предоставено в параметър, не засяга името на входа.

Ако файлът се отваря незабавно с параметър, той се блокира, докато архивите не бъдат изтрити.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Призователят няма изискваното разрешение за достъп.

ArgumentException

code class=“paramref”>path’ е празен, съдържа само бели пространства, или съдържа невалидни знаци. - или - Име на файла, като част от name’, надвишава 100.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

Windows, пътеките трябва да са по-малко от 248 символа, а имената на файла трябва да са по-малко от 260 символа. - или - name’ е твърде дълъг за tar от IEEE 1003.1-1998.

NotSupportedException

code class=“paramref”>path.

DeleteEntry(TarEntry)

Премахва първото възникване на конкретен вход от списъка.

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

Входът трябва да бъде премахнат от списъка с вход.

Returns

TarArchive

Архивът с входа е изтрит.

Examples

Ето как можете да премахнете всички записи, с изключение на последното:

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

DeleteEntry(инт)

Премахване на входа от списъка по индекс.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

Индексът на входа, базиран на нула, трябва да бъде премахнат.

Returns

TarArchive

Архивът с входа е изтрит.

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

Извършва задачите, определени от приложението, свързани с освобождаването, изтеглянето или презареждането на неконтролирани ресурси.

public void Dispose()

Dispose(Боул)

Извършва задачите, определени от приложението, свързани с освобождаването, изтеглянето или презареждането на неконтролирани ресурси.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Трябва ли да се премахнат управляваните ресурси.

ExtractToDirectory(Стрий)

Извлича всички файлове в архива в предоставения каталог.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Пътят към директората за поставяне на извлечените файлове.

Examples

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

Remarks

Ако директорията не съществува, тя ще бъде създадена.

Exceptions

ArgumentNullException

Пътят е нула

PathTooLongException

Windows, пътеките трябва да са по-малко от 248 символа и имената на файла трябва да са по-малко от 260.

SecurityException

Призователят не разполага с изискваното разрешение за достъп до съществуващата директория.

NotSupportedException

Ако директорията не съществува, маршрутът съдържа символ на колона (:) който не е част от етикета на диска (“C:”).

ArgumentException

Пътят е лента с нулева дължина, съдържа само бяло пространство, или съдържа един или повече невалидни символи. Можете да поискате за неподходящи знаци, като използвате метода System.IO.Path.GetInvalid PathChars. - или - пътът е предварително фиксиран с или включва само един символ на колона (:).

IOException

Директорът, посочен по пътя, е файл. - или - Име на мрежата не е известно.

от GZIP(Stream)

gzip архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: gzip архивът се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

GZip екстракционният поток не може да се търси от естеството на алгоритъма на компресията.Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения поток под капака.

Exceptions

InvalidDataException

Архивите са корумпирани.

от GZIP(Стрий)

gzip архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: gzip архивът се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromGZip(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

GZip екстракционният поток не може да се търси от естеството на алгоритъма на компресията.Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения поток под капака.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Пътят ” е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

InvalidDataException

Архивите са корумпирани.

от LZ4(Стрий)

Екстракти предоставени LZ4 архива и състави Aspose.Zip.Tar.tarArchive от извлечените данни.

Важно: Архив LZ4 се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromLZ4(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

LZ4 извличащ поток не може да се търси от естеството на алгоритъма на компресията. Tar архив осигурява възможност за извлечение на произволен запис, така че той трябва да работи търсещи потоци под капака.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Клиентът няма необходимата разрешение за достъп.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

EndOfStreamException

Филмът е твърде кратък.

InvalidDataException

Филмът има погрешен подпис.

от LZ4(Stream)

Екстракти предоставени LZ4 архива и състави Aspose.Zip.Tar.tarArchive от извлечените данни.

Важно: Архив LZ4 се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

LZ4 извличащ поток не може да се търси от естеството на алгоритъма на компресията. Tar архив осигурява възможност за извлечение на произволен запис, така че той трябва да работи търсещи потоци под капака.

Exceptions

ArgumentException

Не може да се чете от source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

Източникът " има погрешен подпис.

от LZMA(Stream)

LZMA архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Архив LZMA се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

LZMA екстракционният поток не може да се търси от естеството на алгоритъма на компресията. Tar.

Exceptions

InvalidDataException

Архивите са корумпирани.

от LZMA(Стрий)

LZMA архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Архив LZMA се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromLZMA(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

LZMA екстракционният поток не може да се търси от естеството на алгоритъма на компресията. Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения ток под капака.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

от LZIP(Stream)

Lzip и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Lzip архива е изцяло извлечена в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

Lzip екстракционният поток не може да се търси от естеството на алгоритъма на компресията. Tar.

Exceptions

InvalidDataException

Архивите са корумпирани.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

от LZIP(Стрий)

Lzip и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Lzip архива е изцяло извлечена в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromLZip(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

Lzip екстракционният поток не може да се търси от естеството на алгоритъма на компресията. Tar.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

InvalidDataException

Архивите са корумпирани.

FromXz(Stream)

xz формат архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: xz архиви се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения поток под капака.

FromXz(Стрий)

xz формат архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: xz архиви се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromXz(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения поток под капака.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

от Z(Stream)

Z формат архиви и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Архив Z се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения поток под капака.

от Z(Стрий)

Z формат архиви и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Архив Z се извлича изцяло в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromZ(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Remarks

Tar архив осигурява възможност за извличане на произволен запис, така че той трябва да работи търсения поток под капака.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

FromZstandard(Stream)

Zstandard архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Стандартните архиви се извличат напълно в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

Източник на архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Exceptions

IOException

Стандартният поток е корумпиран или не може да се чете.

InvalidDataException

Данните са корумпирани.

FromZstandard(Стрий)

Zstandard архива и съставляват Aspose.Zip.Tar.TarArchive.

Важно: Стандартните архиви се извличат напълно в рамките на този метод, съдържанието му се съхранява вътрешно.

public static TarArchive FromZstandard(string path)

Parameters

path string

Пътят към архивите.

Returns

TarArchive

Пример на Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

Файлът в path" е в невалиден формат.

DirectoryNotFoundException

Определеният маршрут е невалиден, като например да се намира на безкартиран диск.

FileNotFoundException

Документът не е намерен.

IOException

Стандартният поток е корумпиран или не може да се чете.

InvalidDataException

Данните са корумпирани.

Save(Тръмп или Тарформат?)

Съхранява архиви към предоставения поток.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

Examples

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

Remarks

Трябва да е писателно.

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(Тръмп или ТарФормат?)

Съхранява архиви към предоставен дестинационен файл.

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

Parameters

destinationFileName string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

Examples

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

Remarks

Възможно е да се съхранява архив по същия път, от който е изтеглен. обаче, това не се препоръчва, защото този подход използва копиране на временно файл.

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

code class=“paramref”>destinationFileName’, име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 символа, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

code class=“paramref”>destinationFileName).

IOException

Една I/O грешка се появи при отваряне на файла.

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

Документът не е намерен.

SaveGzipped(Тръмп или Тарформат?)

Съхранява архиви към потока с компресия gzip.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Трябва да е писателно.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Тръмп или ТарФормат?)

Съхранява архивите на файла по пътя с компресия gzip.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

SaveLZ4 компресирани(Тръмп или Тарформат?)

Съхранява архиви към потока с LZ4 компресия.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Трябва да е писателно.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLZ4 компресирани(Тръмп или ТарФормат?)

Съхранява архивите на файла по пътя с LZ4 компресия.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

Предоставяне на компреси(Тръмп или Тарформат?)

Съхранява архиви към потока с LZMA компресия.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Трябва да е писателно.

Важно: архивът на тарата се състои и след това се компресира в рамките на този метод, съдържанието му се запазва вътрешно.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Предоставяне на компреси(Тръмп или ТарФормат?)

Съхранява архиви към файла по пътя с lzma компресия.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Важно: архивът на тарата се състои и след това се компресира в рамките на този метод, съдържанието му се запазва вътрешно.

Exceptions

UnauthorizedAccessException

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Тръмп или Тарформат?)

Съхранява архиви към потока с lzip компресия.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Трябва да е писателно.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Тръмп или ТарФормат?)

Съхранява архиви към файла по пътя с lzip компресия.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Поток, TarFormat?, XzArchiveSettings)

Съхранява архиви към потока с xz компресия.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

settings XzArchiveSettings

Комплект от настройки на конкретен xz архив: размер на речника, размерът на блока, тип проверка.

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

Потокът трябва да бъде писаем.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Стринг, TarFormat?, XzArchiveSettings)

Съхранява архиви по пътя с xz компресия.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

settings XzArchiveSettings

Комплект от настройки на конкретен xz архив: размер на речника, размерът на блока, тип проверка.

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

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

Спасител компресиран(Тръмп или Тарформат?)

Съхранява архиви към потока с компресия Z.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Трябва да е писателно.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Спасител компресиран(Тръмп или ТарФормат?)

Съхранява архиви по пътя с компресия Z.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Тръмп или Тарформат?)

Съхранява архиви към потока с стандартна компресия.

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

Parameters

output Stream

Пътят на дестинацията.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Трябва да е писателно.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Тръмп или ТарФормат?)

Съхранява архивите на файла по пътя с стандартна компресия.

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

Parameters

path string

Ако посоченото име на файла указва на съществуващ файл, той ще бъде надписано.

format TarFormat ?

Определя формата на заглавието на тарата. нулевата стойност ще бъде третирана като USTar, когато е възможно.

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

Призователят не разполага с изискваното разрешение. -или- path’ посочен единствено четене файл или директория.

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

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

DirectoryNotFoundException

Специфичният path’ е невалиден (например, той е на немапиран диск).

NotSupportedException

path’ is in an invalid format.

 Български