Class ZArchive

Class ZArchive

Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)

このクラスはZ(圧縮)アーカイブファイルを表します。Zアーカイブを構成または抽出するために使用します。

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

継承

objectZArchive

実装

IArchive, IDisposable, IArchiveFileEntry

継承されたメンバー

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

備考

詳細については、https://docs.fileformat.com/compression/z/ を参照してください。

コンストラクタ

ZArchive()

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

public ZArchive()

ZArchive(Stream, ZArchiveLoadOptions)

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

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

パラメータ

source Stream

アーカイブのソース。

loadOptions ZArchiveLoadOptions

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

備考

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

例外

ArgumentException

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

ArgumentNullException

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)メソッドを参照してください。

例外

ArgumentNullException

pathはnullです。

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

メソッド

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"));
    }
}

例外

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfoはnullです。

DirectoryNotFoundException

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

IOException

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

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");
    }
}

例外

ArgumentNullException

pathはnullです。

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

InvalidDataException

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

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

パラメータ

destinationDirectory string

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

備考

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

例外

ArgumentNullException

destinationDirectoryはnullです。

PathTooLongException

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

SecurityException

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

NotSupportedException

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

ArgumentException

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

IOException

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

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はシーク可能でなければなりません。

例外

ArgumentException

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

ArgumentNullException

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");
}

例外

ArgumentNullException

destinationFileNameはnullです。

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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");
}

例外

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfoはnullです。

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string sourcePath)

パラメータ

sourcePath string

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

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

例外

ArgumentNullException

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

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 日本語