TarArchive.Save

Save(Stream, TarFormat?)

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

public void Save(Stream output, TarFormat? format = default)
パラメータタイプ説明
outputStream宛先ストリーム。
formatNullable`1tar ヘッダー形式を定義します。可能な場合、NULL 値は UStar として扱われます。

例外

例外調子
ArgumentExceptionoutput書き込み不可です。 - また -output抽出元のストリームと同じです。 - または - アーカイブを保存することはできませんformatフォーマット制限のため。

備考

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

例

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

関連項目

Save(string, TarFormat?)

指定された宛先ファイルにアーカイブを保存します。

public void Save(string destinationFileName, TarFormat? format = default)
パラメータタイプ説明
destinationFileNameString作成するアーカイブのパス。指定したファイル名が既存のファイルを指している場合、上書きされます。
formatNullable`1tar ヘッダー形式を定義します。可能な場合、NULL 値は UStar として扱われます。

例外

例外調子
ArgumentExceptiondestinationFileName長さがゼロの文字列であるか、空白のみが含まれているか、System.IO.Path.InvalidPathChars で定義されている 1 つ以上の無効な文字が含まれています。
ArgumentNullExceptiondestinationFileName無効である。
PathTooLongException指定されたdestinationFileName、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windows ベースのプラットフォームでは、パスは 248 文字未満、ファイル名は 260 文字未満である必要があります。
DirectoryNotFoundException指定されたdestinationFileNameは無効です (たとえば、マップされていないドライブ上にあります)。
IOExceptionファイルを開くときに入出力エラーが発生しました。
UnauthorizedAccessExceptiondestinationFileName読み取り専用のファイルを指定し、アクセスは読み取りではありません。- または- パスにディレクトリを指定しました。- または- 呼び出し元に必要な権限がありません。
NotSupportedExceptiondestinationFileNameは無効な形式です。

備考

アーカイブをロード元と同じパスに保存することもできます。 ただし、この方法では一時ファイルへのコピーが使用されるため、これはお勧めできません。

例

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

関連項目

TarArchive.ExtractToDirectory TarArchive.SaveGzipped