Class TarArchive

Class TarArchive

名称: Aspose.Zip.Tar 組み合わせ: Aspose.Zip.dll (25.5.0)

このクラスはタールアーカイブファイルを表します.それを組み立て、抽出、または更新するために使用します。

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

相続人

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

Constructors

TarArchive()

Aspose.Zip.Tar.TarArchive クラスの新しいインスタンスを開始します。

public TarArchive()

Examples

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

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

TarArchive(Stream)

Aspose.Zip.Archive クラスの新しい例を開始し、アーカイブから抽出できる入力リストを構成します。

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

アーカイブの情報源は、検索可能でなければならない。

Examples

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

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

Remarks

このメーカーは、いかなる入り口も取り除くことはありません. Aspose.Zip.Tar.TarEntry.Open 方法を参照してください。

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(ストレッチ)

Aspose.Zip.Tar.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(ディレクトリ情報、ボール)

アーカイブにすべてのファイルとディレクトリを繰り返し追加します。

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(ストリーム、ストリーム、ファイルシステム情報)

ファイル内で単一のエントリーを作成します。

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(ストリップ、ファイルインフォ、ボール)

ファイル内で単一のエントリーを作成します。

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 文字未満でなければなりません。

NotSupportedException

path’ のファイルには、列の真ん中のコロン(:)が含まれています。

DeleteEntry(TarEntry)

入力リストから特定の入力の最初の発生を削除します。

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

入力リストから削除するための入力。

Returns

TarArchive

エントリーを含むアーカイブが削除されました。

Examples

以下は、最後の1を除くすべての投稿を削除する方法です。

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

パスはゼロの長さの線であり、白いスペースのみを含み、あるいは1つまたは複数の不適切な文字が含まれています. 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.Tarアーカイブ

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.Tarアーカイブ

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.Tarアーカイブ

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.Tarアーカイブ

Remarks

LZ4抽出ストリームは圧縮アルゴリズムの性質によって検索できない。TARアーカイブは、任意の記録を引き出すための便利性を提供するので、ハードの下で検索可能な流れを実行する必要があります。

Exceptions

ArgumentException

読み取れない source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

<コードクラス=“paramref”>ソース」が間違ったサインを持っています。

からLZMA(Stream)

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

重要: LZMA アーカイブはこの方法で完全に抽出され、そのコンテンツは内部に保存されます。

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

アーカイブの源です。

Returns

TarArchive

Aspose.Zip.Tar.Tarアーカイブ

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.Tarアーカイブ

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.Tarアーカイブ

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.Tarアーカイブ

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.Tarアーカイブ

Remarks

Tar アーカイブは、任意のレコードを抽出するための便利性を提供するので、ハードの下で検索可能なストリームを実行する必要があります。

FromXz(ストレッチ)

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

重要: xz アーカイブはこの方法内で完全に抽出され、そのコンテンツは内部に保存されます。

public static TarArchive FromXz(string path)

Parameters

path string

ファイルへの道のり。

Returns

TarArchive

Aspose.Zip.Tar.Tarアーカイブ

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 を構成します。

重要: Z アーカイブはこの方法内で完全に抽出され、そのコンテンツは内部に保存されます。

public static TarArchive FromZ(Stream source)

Parameters

source Stream

アーカイブの源です。

Returns

TarArchive

Aspose.Zip.Tar.Tarアーカイブ

Remarks

Tar アーカイブは、任意のレコードを抽出するための便利性を提供するので、ハードの下で検索可能なストリームを実行する必要があります。

からZ(ストレッチ)

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

重要: Z アーカイブはこの方法内で完全に抽出され、そのコンテンツは内部に保存されます。

public static TarArchive FromZ(string path)

Parameters

path string

ファイルへの道のり。

Returns

TarArchive

Aspose.Zip.Tar.Tarアーカイブ

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 を構成しています。

重要: Z標準アーカイブはこの方法内で完全に抽出され、そのコンテンツは内部に保存されます。

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

アーカイブの源です。

Returns

TarArchive

Aspose.Zip.Tar.Tarアーカイブ

Exceptions

IOException

Zstandard ストリームは腐敗するか、読めないか。

InvalidDataException

データが腐敗している。

FromZstandard(ストレッチ)

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

重要: Z標準アーカイブはこの方法内で完全に抽出され、そのコンテンツは内部に保存されます。

public static TarArchive FromZstandard(string path)

Parameters

path string

ファイルへの道のり。

Returns

TarArchive

Aspose.Zip.Tar.Tarアーカイブ

Exceptions

ArgumentNullException

path’ is null.

ArgumentException

path’ は空っぽで、白いスペースのみが含まれ、または無効な文字が含まれています。

UnauthorizedAccessException

path" ファイルへのアクセスは拒否されます。

PathTooLongException

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

NotSupportedException

path" のファイルは、不適切な形式です。

DirectoryNotFoundException

指定されたルートは無効です、例えば、マッピングされていないドライブにあります。

FileNotFoundException

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

IOException

Zstandard ストリームは腐敗するか、読めないか。

InvalidDataException

データが腐敗している。

Save(ストリーム、ターフォーマット?)

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

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

Parameters

output Stream

目的地の流れ

format TarFormat ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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 ?

タール ヘッダー フォーマットを定義します. 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.

SaveLZ4 圧縮(ストリート、トルフォーマット?)

LZ4 圧縮でファイルにアーカイブを保存します。

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

Parameters

path string

ファイル名が既存のファイルを指定した場合、それは書き換えられます。

format TarFormat ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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 ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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 ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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(ストリーム、ターフォーマット、XzArchiveSettings)

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

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

Parameters

output Stream

目的地の流れ

format TarFormat ?

タール ヘッダー フォーマットを定義します. 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(ストリップ、TARフォーマット、XzArchiveSettings)

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

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

Parameters

path string

ファイル名が既存のファイルを指定した場合、それは書き換えられます。

format TarFormat ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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.

サブコンプレッサ(ストリーム、ターフォーマット?)

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

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

Parameters

output Stream

目的地の流れ

format TarFormat ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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(ストリーム、ターフォーマット?)

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

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

Parameters

output Stream

目的地の流れ

format TarFormat ?

タール ヘッダー フォーマットを定義します. 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 ?

タール ヘッダー フォーマットを定義します. 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

呼び出しには必要な許可がありません. -or- 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.

 日本語