Class ZArchive

sourceはシーク可能ではありません。

sourceはnullです。

ZArchive(string, ZArchiveLoadOptions)

解凍用に準備されたAspose.Zip.Z.ZArchiveクラスの新しいインスタンスを初期化します。

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

パラメータ

path string

アーカイブのソースへのパス。

loadOptions ZArchiveLoadOptions

アーカイブを読み込むためのオプション。

備考

このコンストラクタは解凍を行いません。解凍にはAspose.Zip.Z.ZArchive.Extract(System.IO.Stream)メソッドを参照してください。

例外

pathはnullです。

呼び出し元はアクセスするために必要な権限を持っていません。

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

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

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

DirectoryNotFoundException

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

FileNotFoundException

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

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

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

メソッド

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

パラメータ

disposing bool

マネージリソースを解放すべきかどうか。

Extract(Stream)

Zアーカイブをストリームに抽出します。

public void Extract(Stream destination)

パラメータ

destination Stream

解凍されたデータを格納するためのストリーム。

例

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

例外

InvalidDataException

データを解凍できません。

Extract(FileInfo)

Zアーカイブをファイルに抽出します。

public void Extract(FileInfo fileInfo)

パラメータ

fileInfo FileInfo

解凍されたデータを格納するためのFileInfo。

例

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

例外

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

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

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfoはnullです。

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

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

InvalidDataException

データを解凍できません。

Extract(string)

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

public FileInfo Extract(string path)

パラメータ

path string

解凍されたデータを格納するファイルへのパス。

戻り値

FileInfo

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

例

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

例外

pathはnullです。

呼び出し元はアクセスするために必要な権限を持っていません。

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

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

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

InvalidDataException

データを解凍できません。

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

パラメータ

destinationDirectory string

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

備考

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

例外

destinationDirectoryはnullです。

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

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

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

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

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

Save(Stream, ZArchiveSaveOptions)

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

public void Save(Stream output, ZArchiveSaveOptions settings = null)

パラメータ

output Stream

宛先ストリーム。

settings ZArchiveSaveOptions

アーカイブ構成のオプション設定。

例

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

備考

outputはシーク可能でなければなりません。

例外

outputはシークをサポートしていません。

outputはnullです。

Save(string, ZArchiveSaveOptions)

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

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

パラメータ

destinationFileName string

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

settings ZArchiveSaveOptions

アーカイブ構成のオプション設定。

例

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

例外

destinationFileNameはnullです。

呼び出し元はアクセスするために必要な権限を持っていません。

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

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

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

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

SetSource(Stream)

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

public void SetSource(Stream source)

パラメータ

source Stream

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

例

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

パラメータ

fileInfo FileInfo

入力ストリームとして開かれるFileInfo。

例

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

例外

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

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

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfoはnullです。

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

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

SetSource(string)

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

public void SetSource(string sourcePath)

パラメータ

sourcePath string

入力ストリームとして開かれるファイルへのパス。

例

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

例外

sourcePathはnullまたは空文字列です。

呼び出し元はリソースにアクセスするために必要な権限を持っていません。

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

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

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