Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
このクラスはZ(圧縮)アーカイブファイルを表します。Zアーカイブを構成または抽出するために使用します。
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
継承
実装
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)メソッドを参照してください。
例外
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文字未満でなければなりません。
path
に文字列の中間にコロン(:)が含まれています。
ファイルが見つかりません。
指定されたパスが無効です。たとえば、マップされていないドライブ上にある場合などです。
ファイルはすでに開いています。
メソッド
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);
}
}
}
例外
データを解凍できません。
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
を開くために必要な権限を持っていません。
ファイルパスが空であるか、空白のみを含んでいます。
ファイルが見つかりません。
ファイルへのパスが読み取り専用であるか、ディレクトリです。
fileInfo
はnullです。
指定されたパスが無効です。たとえば、マップされていないドライブ上にある場合などです。
ファイルはすでに開いています。
データを解凍できません。
Extract(string)
パスによってZアーカイブをファイルに抽出します。
public FileInfo Extract(string path)
パラメータ
path
string
解凍されたデータを格納するファイルへのパス。
戻り値
抽出されたファイルの情報。
例
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
例外
path
はnullです。
呼び出し元はアクセスするために必要な権限を持っていません。
path
は空であるか、空白のみを含むか、無効な文字を含んでいます。
ファイルpath
へのアクセスが拒否されました。
指定されたpath
、ファイル名、またはその両方がシステム定義の最大長を超えています。たとえば、Windowsベースのプラットフォームでは、パスは248文字未満でなければならず、ファイル名は260文字未満でなければなりません。
path
に文字列の中間にコロン(:)が含まれています。
データを解凍できません。
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
を開くために必要な権限を持っていません。
ファイルパスが空であるか、空白のみを含んでいます。
ファイルが見つかりません。
ファイルへのパスが読み取り専用であるか、ディレクトリです。
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文字未満でなければなりません。
sourcePath
に文字列の中間にコロン(:)が含まれています。