Class GzipArchive

pathはnullです。

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

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

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

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

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

プロパティ

Name

元のファイルの名前。

public string Name { get; }

プロパティ値

string

メソッド

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.gz"))
{
     archive.Extract(httpResponseStream);
}

例外

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

InvalidDataException

ストリームが破損しており、有効なデータを含んでいません。

Extract(string)

パスによってファイルにアーカイブを抽出します。

public FileInfo Extract(string path)

パラメータ

path string

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

戻り値

FileInfo

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

例外

pathはnullです。

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

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

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

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

InvalidDataException

ストリームが破損しており、有効なデータを含んでいません。

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

パラメータ

destinationDirectory string

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

備考

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

例外

destinationDirectoryはnullです。

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

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

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

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

IOException

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

Open()

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

public Stream Open()

戻り値

Stream

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

例

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

using (var archive = new GzipArchive("archive.gz"))
{
    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)

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

public void Save(Stream outputStream)

パラメータ

outputStream Stream

宛先ストリーム。

例

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

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

備考

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

例外

InvalidOperationException

outputStreamは書き込み不可です。

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

Save(string)

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

public void Save(string destinationFileName)

パラメータ

destinationFileName string

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

例

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

例外

destinationFileNameはnullです。

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

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

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

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

destinationFileNameのファイルが文字列の中間にコロン（:）を含んでいます。

SetSource(Stream)

アーカイブ内で圧縮されるコンテンツを設定します。

public void SetSource(Stream source)

パラメータ

source Stream

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

例

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

SetSource(FileInfo)

アーカイブ内で圧縮されるコンテンツを設定します。

public void SetSource(FileInfo fileInfo)

パラメータ

fileInfo FileInfo

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

例

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

SetSource(string)

アーカイブ内で圧縮されるコンテンツを設定します。

public void SetSource(string path)

パラメータ

path string

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

例

パスからファイルのアーカイブを開き、MemoryStreamに抽出します。

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

例外

pathはnullです。

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

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

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