Class TarArchive

Class TarArchive

Название пространства: Aspose.Zip.Tar Ассоциация: Aspose.Zip.dll (25.5.0)

Этот класс представляет собой файл архива 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.TarArchive и составляет входный список, который можно извлечь из архива.

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

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе 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(Стриг, Stream, 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ПathChars. - или - путь заранее установлен с, либо содержат, только один символ колона (:).

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

Указанный 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

path" пустая, содержит только белые пространства или содержит недействительные символы.

UnauthorizedAccessException

Доступ к файлу path" отказывается.

PathTooLongException

Указанный 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

path" пустая, содержит только белые пространства или содержит недействительные символы.

UnauthorizedAccessException

Доступ к файлу path" отказывается.

PathTooLongException

Указанный 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

path" пустая, содержит только белые пространства или содержит недействительные символы.

UnauthorizedAccessException

Доступ к файлу path" отказывается.

PathTooLongException

Указанный 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

path" пустая, содержит только белые пространства или содержит недействительные символы.

UnauthorizedAccessException

Доступ к файлу path" отказывается.

PathTooLongException

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе 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

Указанный 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

path" пустая, содержит только белые пространства или содержит недействительные символы.

UnauthorizedAccessException

Доступ к файлу path" отказывается.

PathTooLongException

Указанный 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

Определенный 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 ?

Определяет формат заголовка тары. нулевая стоимость будет рассматриваться как 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

Указанный 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

Указанный 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

Указанный 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

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

DirectoryNotFoundException

Указанный path’ является недействительным (например, он находится на безкартированном диске).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Stream, 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

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

DirectoryNotFoundException

Указанный path’ является недействительным (например, он находится на безкартированном диске).

NotSupportedException

path’ is in an invalid format.

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

Сберегает архив до потока с 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.

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

Сберегает архив по пути с 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

Указанный 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

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

DirectoryNotFoundException

Указанный path’ является недействительным (например, он находится на безкартированном диске).

NotSupportedException

path’ is in an invalid format.

 Русский