Class TarArchive

Class TarArchive

Названий на: Aspose.Zip.Tar Асамблея: Aspose.Zip.dll (25.5.0)

Цей клас являє собою файл архіву Tar. Використовуйте його для композиції, екстракції або оновлення архівів tar.

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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в 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

Зателефонувач не має необхідного дозволу на доступ до 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

Назва файлу, як частина 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

Назва файлу, як частина 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи. - або - Назва файлу, як частина name’, перевищує 100 символів.

UnauthorizedAccessException

Доступ до файлу path” відмовляється.

PathTooLongException

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

NotSupportedException

Файл в 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path" знаходиться у недійсному форматі.

DirectoryNotFoundException

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

FileNotFoundException

Файл не знайдено.

від Z(Stream)

Екстракти надані Z формат архіву і складається Aspose.Zip.Tar.TarArchive з витягнутих даних.

Важливо: З архіву повністю витягується в рамках цього методу, його вміст зберігається внутрішньо.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

Джерело архіву.

Returns

TarArchive

Про це йдеться в повідомленні Aspose.Zip.Tar.TarArchive

Remarks

Архів Tar забезпечує можливість витягування волевого запису, тому він повинен керувати пошуковим потоком під палицею.

від Z(стрічка)

Екстракти надані Z формат архіву і складається Aspose.Zip.Tar.TarArchive з витягнутих даних.

Важливо: З архіву повністю витягується в рамках цього методу, його вміст зберігається внутрішньо.

public static TarArchive FromZ(string path)

Parameters

path string

Шлях до архіву.

Returns

TarArchive

Про це йдеться в повідомленні Aspose.Zip.Tar.TarArchive

Remarks

Архів Tar забезпечує можливість витягування волевого запису, тому він повинен керувати пошуковим потоком під палицею.

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на 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

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path" знаходиться у недійсному форматі.

DirectoryNotFoundException

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

FileNotFoundException

Файл не знайдено.

IOException

Стандартний потік корумпований або не читається.

InvalidDataException

І дані корумповані.

Save(Тарформат чи Тарформат?)

Зберегти архіви до наданого потоку.

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

Parameters

output Stream

Потік напряму.

format TarFormat ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Визначений destinationFileName’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.

DirectoryNotFoundException

Визначена 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

DirectoryNotFoundException

Визначений path’ є недійсним (наприклад, він знаходиться на безкартованому диску).

NotSupportedException

path’ is in an invalid format.

Створення SaveLZ4Compressed(Тарформат чи Тарформат?)

Збереже архіви до потоку за допомогою компресії LZ4.

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

Parameters

output Stream

Потік напряму.

format TarFormat ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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.

Створення SaveLZ4Compressed(Тарформат чи Тарформат?)

Збереже архіви до файлу шляхом з компресією LZ4.

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

Parameters

path string

Якщо назва файлу вказує на існуючий файл, він буде переписаний.

format TarFormat ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

DirectoryNotFoundException

Визначений path’ є недійсним (наприклад, він знаходиться на безкартованому диску).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Стрим, ТарФормат?, XzArchiveSettings)

Збереже архіви до потоку за допомогою компресії xz.

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

Parameters

output Stream

Потік напряму.

format TarFormat ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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(Стриг, ТарФормат?, XzArchiveSettings)

Збереже архіви до маршруту шляхом з компресією xz.

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

Parameters

path string

Якщо назва файлу вказує на існуючий файл, він буде переписаний.

format TarFormat ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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 ?

Визначити формат заголовка tar. Null значення буде розглядатися як 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

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

DirectoryNotFoundException

Визначений path’ є недійсним (наприклад, він знаходиться на безкартованому диску).

NotSupportedException

path’ is in an invalid format.

 Українська