Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

このクラスはtarアーカイブファイルを表します。tarアーカイブを構成、抽出、または更新するために使用します。

public class TarArchive : IArchive, IDisposable

継承

objectTarArchive

実装

IArchive, IDisposable

継承されたメンバー

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

コンストラクタ

TarArchive()

Aspose.Zip.Tar.TarArchiveクラスの新しいインスタンスを初期化します。

public TarArchive()

次の例は、ファイルを圧縮する方法を示しています。

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

TarArchive(Stream)

Aspose.Zip.Archiveクラスの新しいインスタンスを初期化し、アーカイブから抽出されるエントリリストを構成します。

public TarArchive(Stream sourceStream)

パラメーター

sourceStream Stream

アーカイブのソース。シーク可能である必要があります。

次の例は、すべてのエントリをディレクトリに抽出する方法を示しています。

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

備考

このコンストラクタは、エントリを展開しません。展開するには、Aspose.Zip.Tar.TarEntry.Openメソッドを参照してください。

例外

InvalidDataException

sourceStreamはシーク可能ではありません。

TarArchive(string)

Aspose.Zip.Tar.TarArchiveクラスの新しいインスタンスを初期化し、アーカイブから抽出されるエントリリストを構成します。

public TarArchive(string path)

パラメーター

path string

アーカイブファイルへのパス。

次の例は、すべてのエントリをディレクトリに抽出する方法を示しています。

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

備考

このコンストラクタは、エントリを展開しません。展開するには、Aspose.Zip.Tar.TarEntry.Openメソッドを参照してください。

例外

ArgumentNullException

pathはnullです。

SecurityException

呼び出し元にはアクセスするための必要な権限がありません。

ArgumentException

pathは空であるか、空白文字のみを含むか、無効な文字を含んでいます。

UnauthorizedAccessException

ファイルpathへのアクセスが拒否されました。

PathTooLongException

指定されたpath、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windowsベースのプラットフォームでは、パスは248文字未満でなければならず、ファイル名は260文字未満でなければなりません。

NotSupportedException

pathの文字列の中間にコロン(:)が含まれています。

FileNotFoundException

ファイルが見つかりません。

DirectoryNotFoundException

指定されたパスが無効です(たとえば、マップされていないドライブ上にあるなど)。

IOException

ファイルはすでに開いています。

プロパティ

Entries

アーカイブを構成するAspose.Zip.Tar.TarEntry型のエントリを取得します。

public ReadOnlyCollection<tarentry> Entries { get; }

プロパティ値

ReadOnlyCollection<TarEntry&gt;

メソッド

CreateEntries(DirectoryInfo, bool)

指定されたディレクトリ内のすべてのファイルとディレクトリを再帰的にアーカイブに追加します。

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

パラメーター

directory DirectoryInfo

圧縮するディレクトリ。

includeRootDirectory bool

ルートディレクトリ自体を含めるかどうかを示します。

戻り値

TarArchive

構成されたエントリを持つアーカイブ。

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(tarFile);
    }
}

CreateEntries(string, bool)

指定されたディレクトリ内のすべてのファイルとディレクトリを再帰的にアーカイブに追加します。

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

パラメーター

sourceDirectory string

圧縮するディレクトリ。

includeRootDirectory bool

ルートディレクトリ自体を含めるかどうかを示します。

戻り値

TarArchive

構成されたエントリを持つアーカイブ。

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

例外

ArgumentNullException

sourceDirectoryはnullです。

SecurityException

呼び出し元にはsourceDirectoryにアクセスするための必要な権限がありません。

ArgumentException

sourceDirectoryは、", <, >, または | のような無効な文字を含んでいます。

PathTooLongException

指定されたパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windowsベースのプラットフォームでは、パスは248文字未満でなければならず、ファイル名は260文字未満でなければなりません。指定されたパス、ファイル名、またはその両方が長すぎます。

CreateEntry(string, Stream, FileSystemInfo)

アーカイブ内に単一のエントリを作成します。

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

パラメーター

name string

エントリの名前。

source Stream

エントリの入力ストリーム。

fileInfo FileSystemInfo

圧縮されるファイルまたはフォルダのメタデータ。

戻り値

TarEntry

Tarエントリインスタンス。

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

備考

エントリ名はnameパラメーター内でのみ設定されます。fileInfoパラメーターで提供されたファイル名はエントリ名に影響しません。

fileInfoは、エントリがディレクトリの場合はSystem.IO.DirectoryInfoを参照できます。

例外

PathTooLongException

nameはIEEE 1003.1-1998標準においてtarにとって長すぎます。

ArgumentException

nameの一部としてのファイル名が100文字を超えています。

CreateEntry(string, FileInfo, bool)

アーカイブ内に単一のエントリを作成します。

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

パラメーター

name string

エントリの名前。

fileInfo FileInfo

圧縮されるファイルまたはフォルダのメタデータ。

openImmediately bool

ファイルを即座に開く場合はtrue、そうでない場合はアーカイブ保存時にファイルを開きます。

戻り値

TarEntry

Tarエントリインスタンス。

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

備考

エントリ名はnameパラメーター内でのみ設定されます。fileInfoパラメーターで提供されたファイル名はエントリ名に影響しません。

fileInfoは、エントリがディレクトリの場合はSystem.IO.DirectoryInfoを参照できます。

ファイルがopenImmediatelyパラメーターで即座に開かれる場合、それはアーカイブが破棄されるまでブロックされます。

例外

PathTooLongException

nameはIEEE 1003.1-1998標準においてtarにとって長すぎます。

ArgumentException

nameの一部としてのファイル名が100文字を超えています。

CreateEntry(string, string, bool)

アーカイブ内に単一のエントリを作成します。

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

パラメーター

name string

エントリの名前。

path string

圧縮されるファイルへのパス。

openImmediately bool

ファイルを即座に開く場合はtrue、そうでない場合はアーカイブ保存時にファイルを開きます。

戻り値

TarEntry

Tarエントリインスタンス。

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

備考

エントリ名はnameパラメーター内でのみ設定されます。pathパラメーターで提供されたファイル名はエントリ名に影響しません。

ファイルがopenImmediatelyパラメーターで即座に開かれる場合、それはアーカイブが破棄されるまでブロックされます。

例外

ArgumentNullException

pathはnullです。

SecurityException

呼び出し元には必要な権限がありません。

ArgumentException

pathは空であるか、空白文字のみを含むか、無効な文字を含んでいます。 - または - nameの一部としてのファイル名が100文字を超えています。

UnauthorizedAccessException

ファイルpathへのアクセスが拒否されました。

PathTooLongException

指定されたpath、ファイル名、またはその両方がシステム定義の最大長を超えています。 - または - nameはIEEE 1003.1-1998標準においてtarにとって長すぎます。

NotSupportedException

pathの文字列の中間にコロン(:)が含まれています。

DeleteEntry(TarEntry)

エントリリストから特定のエントリの最初の出現を削除します。

public TarArchive DeleteEntry(TarEntry entry)

パラメーター

entry TarEntry

エントリリストから削除するエントリ。

戻り値

TarArchive

削除されたエントリを持つアーカイブ。

最後のエントリを除くすべてのエントリを削除する方法は次のとおりです:

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

DeleteEntry(int)

インデックスによってエントリをエントリリストから削除します。

public TarArchive DeleteEntry(int entryIndex)

パラメーター

entryIndex int

削除するエントリのゼロベースのインデックス。

戻り値

TarArchive

削除されたエントリを持つアーカイブ。

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

例外

ArgumentOutOfRangeException

entryIndexは0未満です。-または- entryIndexEntriesのカウント以上です。

Dispose()

アンマネージリソースを解放、リリース、またはリセットするためにアプリケーション定義のタスクを実行します。

public void Dispose()

Dispose(bool)

アンマネージリソースを解放、リリース、またはリセットするためにアプリケーション定義のタスクを実行します。

protected virtual void Dispose(bool disposing)

パラメーター

disposing bool

マネージリソースを解放する必要があるかどうか。

ExtractToDirectory(string)

アーカイブ内のすべてのファイルを指定されたディレクトリに抽出します。

public void ExtractToDirectory(string destinationDirectory)

パラメーター

destinationDirectory string

抽出されたファイルを配置するためのディレクトリへのパス。

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

備考

ディレクトリが存在しない場合は、作成されます。

例外

ArgumentNullException

pathはnullです。

PathTooLongException

指定されたパス、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windowsベースのプラットフォームでは、パスは248文字未満でなければならず、ファイル名は260文字未満でなければなりません。

SecurityException

呼び出し元には既存のディレクトリにアクセスするための必要な権限がありません。

NotSupportedException

ディレクトリが存在しない場合、パスにドライブラベル(“C:")の一部ではないコロン文字(:)が含まれています。

ArgumentException

pathはゼロ長の文字列であるか、空白文字のみを含むか、1つ以上の無効な文字を含んでいます。無効な文字をクエリするには、System.IO.Path.GetInvalidPathCharsメソッドを使用できます。 - または - pathはコロン文字(:)で始まるか、またはコロン文字のみを含んでいます。

IOException

pathで指定されたディレクトリはファイルです。 - または - ネットワーク名が不明です。

FromGZip(Stream)

提供されたgzipアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:gzipアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromGZip(Stream source)

パラメーター

source Stream

アーカイブのソース。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

GZip抽出ストリームは圧縮アルゴリズムの性質上シーク可能ではありません。 Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

例外

InvalidDataException

アーカイブが破損しています。

FromGZip(string)

提供されたgzipアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:gzipアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromGZip(string path)

パラメーター

path string

アーカイブファイルへのパス。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

GZip抽出ストリームは圧縮アルゴリズムの性質上シーク可能ではありません。 Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

例外

InvalidDataException

アーカイブが破損しています。

FromLZMA(Stream)

提供されたLZMAアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:LZMAアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromLZMA(Stream source)

パラメーター

source Stream

アーカイブのソース。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

LZMA抽出ストリームは圧縮アルゴリズムの性質上シーク可能ではありません。Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromLZMA(string)

提供されたLZMAアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:LZMAアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromLZMA(string path)

パラメーター

path string

アーカイブファイルへのパス。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

LZMA抽出ストリームは圧縮アルゴリズムの性質上シーク可能ではありません。Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromLZip(Stream)

提供されたlzipアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:lzipアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromLZip(Stream source)

パラメーター

source Stream

アーカイブのソース。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

Lzip抽出ストリームは圧縮アルゴリズムの性質上シーク可能ではありません。Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromLZip(string)

提供されたlzipアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:lzipアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromLZip(string path)

パラメーター

path string

アーカイブファイルへのパス。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

Lzip抽出ストリームは圧縮アルゴリズムの性質上シーク可能ではありません。Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromXz(Stream)

提供されたxz形式のアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:xzアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromXz(Stream source)

パラメーター

source Stream

アーカイブのソース。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromXz(string)

提供されたxz形式のアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:xzアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromXz(string path)

パラメーター

path string

アーカイブファイルへのパス。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromZ(Stream)

提供されたZ形式のアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:Zアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromZ(Stream source)

パラメーター

source Stream

アーカイブのソース。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromZ(string)

提供されたZ形式のアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:Zアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromZ(string path)

パラメーター

path string

アーカイブファイルへのパス。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

備考

Tarアーカイブは任意のレコードを抽出する機能を提供するため、内部でシーク可能なストリームを操作する必要があります。

FromZstandard(Stream)

提供されたZstandardアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:Zstandardアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromZstandard(Stream source)

パラメーター

source Stream

アーカイブのソース。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

例外

IOException

Zstandardストリームが破損しているか、読み取り可能ではありません。

InvalidDataException

データが破損しています。

FromZstandard(string)

提供されたZstandardアーカイブを抽出し、抽出されたデータからAspose.Zip.Tar.TarArchiveを構成します。

重要:Zstandardアーカイブはこのメソッド内で完全に抽出され、その内容は内部に保持されます。メモリ消費に注意してください。

public static TarArchive FromZstandard(string path)

パラメーター

path string

アーカイブファイルへのパス。

戻り値

TarArchive

Aspose.Zip.Tar.TarArchiveのインスタンス

例外

IOException

Zstandardストリームが破損しているか、読み取り可能ではありません。

InvalidDataException

データが破損しています。

Save(Stream, TarFormat?)

提供されたストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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

備考

outputは書き込み可能でなければなりません。

例外

ArgumentException

outputは書き込み可能ではありません。 - または - outputは抽出元のストリームと同じです。 - または - formatの制限によりアーカイブを保存できません。

Save(string, TarFormat?)

指定されたパスにアーカイブを保存します。

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

パラメーター

destinationFileName string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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

備考

アーカイブを読み込んだのと同じパスに保存することも可能です。 ただし、このアプローチでは一時ファイルへのコピーを使用するため、推奨されません。

例外

ArgumentException

destinationFileNameはゼロ長の文字列であるか、空白文字のみを含むか、System.IO.Path.InvalidPathCharsで定義される1つ以上の無効な文字を含んでいます。

ArgumentNullException

destinationFileNameはnullです。

PathTooLongException

指定されたdestinationFileName、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windowsベースのプラットフォームでは、パスは248文字未満でなければならず、ファイル名は260文字未満でなければなりません。

DirectoryNotFoundException

指定されたdestinationFileNameは無効です(たとえば、マップされていないドライブ上にあるなど)。

IOException

ファイルを開いているときにI/Oエラーが発生しました。

UnauthorizedAccessException

destinationFileNameが読み取り専用のファイルを指定し、アクセスが読み取りではありません。 - または - 指定されたパスがディレクトリです。 - または - 呼び出し元には必要な権限がありません。

NotSupportedException

destinationFileNameが無効な形式です。

FileNotFoundException

ファイルが見つかりません。

SaveGzipped(Stream, TarFormat?)

gzip圧縮でストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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);
        }
    }
}

備考

outputは書き込み可能でなければなりません。

例外

ArgumentNullException

outputはnullです。

ArgumentException

outputは書き込み可能ではありません。

SaveGzipped(string, TarFormat?)

gzip圧縮でパスにファイルを保存します。

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

パラメーター

path string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

LZMA圧縮でストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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);
        }
    }
}

備考

outputは書き込み可能でなければなりません。

重要:tarアーカイブはこのメソッド内で構成されてから圧縮され、その内容は内部に保持されます。メモリ消費に注意してください。

例外

ArgumentNullException

outputはnullです。

ArgumentException

outputは書き込み可能ではありません。

SaveLZMACompressed(string, TarFormat?)

LZMA圧縮でパスにファイルを保存します。

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

パラメーター

path string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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");
    }
}

備考

重要:tarアーカイブはこのメソッド内で構成されてから圧縮され、その内容は内部に保持されます。メモリ消費に注意してください。

SaveLzipped(Stream, TarFormat?)

lzip圧縮でストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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);
        }
    }
}

備考

outputは書き込み可能でなければなりません。

例外

ArgumentNullException

outputはnullです。

ArgumentException

outputは書き込み可能ではありません。

SaveLzipped(string, TarFormat?)

lzip圧縮でパスにファイルを保存します。

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

パラメーター

path string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

xz圧縮でストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

settings XzArchiveSettings

特定のxzアーカイブの設定セット:辞書サイズ、ブロックサイズ、チェックタイプ。

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);
        }
    }
}

備考

outputは書き込み可能でなければなりません。

例外

ArgumentNullException

outputはnullです。

ArgumentException

outputは書き込み可能ではありません。

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

xz圧縮でパスにアーカイブを保存します。

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

パラメーター

path string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

settings XzArchiveSettings

特定の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.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

Z圧縮でストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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);
        }
    }
}

備考

outputは書き込み可能でなければなりません。

例外

ArgumentNullException

outputはnullです。

ArgumentException

outputは書き込み可能ではありません。

SaveZCompressed(string, TarFormat?)

Z圧縮でパスにアーカイブを保存します。

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

パラメーター

path string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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");
    }
}

SaveZstandard(Stream, TarFormat?)

Zstandard圧縮でストリームにアーカイブを保存します。

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

パラメーター

output Stream

宛先ストリーム。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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);
        }
    }
}

備考

outputは書き込み可能でなければなりません。

例外

ArgumentNullException

outputはnullです。

ArgumentException

outputは書き込み可能ではありません。

SaveZstandard(string, TarFormat?)

Zstandard圧縮でパスにアーカイブを保存します。

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

パラメーター

path string

作成されるアーカイブのパス。指定されたファイル名が既存のファイルを指す場合は、上書きされます。

format TarFormat?

tarヘッダー形式を定義します。null値は可能な場合はUSTarとして扱われます。

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");
    }
}
 日本語