TarArchive.CreateEntry

CreateEntry(string, Stream, FileSystemInfo)

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

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)
パラメータタイプ説明
nameStringエントリの名前。
sourceStreamエントリの入力ストリーム。
fileInfoFileSystemInfo圧縮するファイルまたはフォルダーのメタデータ。

戻り値

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

例外

例外調子
PathTooLongExceptionname IEEE 1003.1-1998 標準の tar には長すぎます。
ArgumentException一部としてのファイル名name、100 シンボルを超えています。

備考

エントリ名は、nameパラメータ。で提供されているファイル名fileInfoパラメータは、エントリ名には影響しません。

fileInfo参照できますDirectoryInfoエントリがディレクトリの場合。

例

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

関連項目

CreateEntry(string, FileInfo, bool)

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

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
パラメータタイプ説明
nameStringエントリの名前。
fileInfoFileInfo圧縮するファイルまたはフォルダーのメタデータ。
openImmediatelyBooleanファイルをすぐに開く場合は true、それ以外の場合はアーカイブ保存時にファイルを開きます。

戻り値

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

例外

例外調子
PathTooLongExceptionname IEEE 1003.1-1998 標準の tar には長すぎます。
ArgumentException一部としてのファイル名name、100 シンボルを超えています。

備考

エントリ名は、nameパラメータ。で提供されているファイル名fileInfoパラメータは、エントリ名には影響しません。

fileInfo参照できますDirectoryInfoエントリがディレクトリの場合。

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

例

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

関連項目

CreateEntry(string, string, bool)

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

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)
パラメータタイプ説明
nameStringエントリの名前。
pathString圧縮するファイルへのパス。
openImmediatelyBooleanファイルをすぐに開く場合は true、それ以外の場合はアーカイブ保存時にファイルを開きます。

戻り値

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

例外

例外調子
ArgumentNullExceptionpath無効である。
SecurityException呼び出し元には、アクセスに必要なアクセス許可がありません。
ArgumentExceptionのpathが空であるか、空白のみが含まれているか、無効な文字が含まれています。 - または - の一部としてのファイル名name、100 シンボルを超えています。
UnauthorizedAccessExceptionファイルへのアクセスpath否定された。
PathTooLongException指定されたpath、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満、ファイル名は 260 文字未満である必要があります。 - また -name IEEE 1003.1-1998 標準の tar には長すぎます。
NotSupportedExceptionファイルpath文字列の途中にコロン (:) が含まれています。

備考

エントリ名は、nameパラメータ。で提供されているファイル名pathパラメータは、エントリ名には影響しません。

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

例

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

関連項目

TarArchive.CreateEntries TarArchive.DeleteEntry