Class XzArchive

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

source は null です。

XzArchive(string)

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

public XzArchive(string path)

パラメーター

path string

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

備考

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

例外

path は null です。

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

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

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

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

path に文字列の途中にコロン (:) が含まれています。

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

指定されたパスが無効であり、マッピングされていないドライブにある場合などです。

InvalidOperationException

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

メソッド

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

パラメーター

disposing bool

マネージリソースを解放する必要があるかどうか。

Extract(Stream)

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

public void Extract(Stream destination)

パラメーター

destination Stream

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

例

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

例外

アーカイブヘッダーとサービス情報が読み取られていません。

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

パラメーター

fileInfo FileInfo

解凍されたデータを保存するための FileInfo。

例

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

例外

InvalidOperationException

アーカイブヘッダーとサービス情報が読み取られていません。

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

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

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

ファイルへのパスが読み取り専用またはディレクトリです。

fileInfo は null です。

指定されたパスが無効であり、マッピングされていないドライブにある場合などです。

InvalidOperationException

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

Extract(string)

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

public FileInfo Extract(string path)

パラメーター

path string

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

戻り値

FileInfo

抽出されたデータを含む System.IO.FileInfo インスタンス。

例

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

例外

アーカイブヘッダーとサービス情報が読み取られていません。

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 メソッドを使用できます。 -または- パスがコロン文字 (:) で始まるか、コロン文字 (:) のみを含んでいます。

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

Save(Stream)

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

public void Save(Stream output)

パラメーター

output Stream

宛先ストリーム。

例

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

備考

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

例外

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

output は null です。

Save(string)

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

public void Save(string destinationFileName)

パラメーター

destinationFileName string

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

例

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

例外

destinationFileName は null です。

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

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

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

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

destinationFileName に文字列の途中にコロン (:) が含まれています。

SetSource(Stream)

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

public void SetSource(Stream source)

パラメーター

source Stream

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

例

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

例外

source ストリームはシーク可能ではありません。

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

パラメーター

fileInfo FileInfo

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

例

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

例外

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

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

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

ファイルへのパスが読み取り専用またはディレクトリです。

fileInfo は null です。

指定されたパスが無効であり、マッピングされていないドライブにある場合などです。

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

SetSource(string)

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

public void SetSource(string sourcePath)

パラメーター

sourcePath string

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

例

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

例外

sourcePath は null です。

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

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

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

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