Class ZstandardArchive

pathはnullです。

呼び出し元は必要なアクセス権を持っていません。

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

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

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

path内にコロン（:）が含まれています。

メソッド

Dispose()

管理されていないリソースを解放、リリース、またはリセットするために関連付けられたアプリケーション定義のタスクを実行します。

public void Dispose()

Dispose(bool)

管理されていないリソースを解放、リリース、またはリセットするために関連付けられたアプリケーション定義のタスクを実行します。

protected virtual void Dispose(bool disposing)

パラメーター

disposing bool

管理されたリソースを破棄するべきかどうか。

Extract(Stream)

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

public void Extract(Stream destination)

パラメーター

destination Stream

宛先ストリーム。書き込み可能である必要があります。

例

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

例外

destinationは書き込みをサポートしていません。

Extract(string)

指定されたパスのファイルにアーカイブを抽出します。

public FileInfo Extract(string path)

パラメーター

path string

宛先ファイルへのパス。ファイルが既に存在する場合は上書きされます。

戻り値

FileInfo

抽出されたファイルの情報。

例外

pathはnullです。

呼び出し元は必要なアクセス権を持っていません。

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

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

ファイルpath内にコロン（:）が含まれています。

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

パラメーター

destinationDirectory string

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

備考

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

例外

destinationDirectoryはnullです。

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

呼び出し元は既存のディレクトリへのアクセスに必要な権限を持っていません。

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

destinationDirectoryはゼロ長の文字列であるか、空白文字のみを含むか、無効な文字を1つ以上含んでいます。無効な文字をクエリするには、System.IO.Path.GetInvalidPathCharsメソッドを使用できます。 -または- パスがプレフィックスされているか、コロン文字（:）のみを含んでいます。

IOException

指定されたパスはファイルです。 -または- ネットワーク名が不明です。

Open()

抽出のためにアーカイブを開き、アーカイブの内容を持つストリームを提供します。

public Stream Open()

戻り値

Stream

アーカイブの内容を表すストリームです。

例

アーカイブを抽出し、抽出された内容をファイルストリームにコピーします。

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

.NET 4.0以降ではStream.CopyToメソッドを使用できます： `unpacked.CopyTo(extracted);`

備考

ストリームから読み取ってファイルの元の内容を取得します。例のセクションを参照してください。

Save(Stream, ZstandardSaveOptions)

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

パラメーター

outputStream Stream

宛先ストリームです。

settings ZstandardSaveOptions

アーカイブ作成のためのオプション設定です。

例

圧縮されたデータをhttpレスポンスストリームに書き込みます。

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

備考

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

例外

InvalidOperationException

outputStreamは書き込み不可です。

ソースが提供されていません。

Save(string, ZstandardSaveOptions)

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

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

パラメーター

destinationFileName string

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

settings ZstandardSaveOptions

アーカイブ作成のためのオプション設定です。

例

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

例外

destinationFileNameはnullです。

呼び出し元は必要なアクセス権を持っていません。

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

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

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

ファイルdestinationFileName内にコロン（:）が含まれています。

Save(FileInfo, ZstandardSaveOptions)

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

パラメーター

destination FileInfo

宛先ストリームとして開かれるFileInfoです。

settings ZstandardSaveOptions

アーカイブ作成のためのオプション設定です。

例

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.zst"));
}

例外

呼び出し元はdestinationを開くために必要な権限を持っていません。

ファイルパスが空であるか、空白文字のみを含んでいます。

FileNotFoundException

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

ファイルへのパスが読み取り専用であるか、ディレクトリです。

DirectoryNotFoundException

destinationはnullです。

指定されたパスが無効です（たとえば、マップされていないドライブにある場合）。

IOException

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

SetSource(Stream)

アーカイブ内に圧縮される内容を設定します。

public void SetSource(Stream source)

パラメーター

source Stream

アーカイブの入力ストリームです。

例

using (var archive = new ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

SetSource(FileInfo)

アーカイブ内に圧縮される内容を設定します。

public void SetSource(FileInfo fileInfo)

パラメーター

fileInfo FileInfo

圧縮されるファイルへの参照です。

例

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.zst");
}

SetSource(string)

アーカイブ内に圧縮される内容を設定します。

public void SetSource(string path)

パラメーター

path string

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

例

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.zst");
}

例外

pathはnullです。

呼び出し元は必要なアクセス権を持っていません。

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

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