Class XzArchive
Namespace: Aspose.Zip.Xz
Assembly: Aspose.Zip.dll (25.1.0)
このクラスは xz アーカイブファイルを表します。xz アーカイブを作成および抽出するために使用します。
public class XzArchive : 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()
コンストラクター
XzArchive(XzArchiveSettings)
Aspose.Zip.Xz.XzArchive クラスの新しいインスタンスを初期化し、xz 形式でアーカイブを作成します。
public XzArchive(XzArchiveSettings settings = null)
パラメーター
settings
XzArchiveSettings
特定の xz アーカイブの設定のセット: 辞書サイズ、ブロックサイズ、チェックタイプ。
XzArchive(Stream)
解凍のために準備された Aspose.Zip.Xz.XzArchive クラスの新しいインスタンスを初期化します。
public XzArchive(Stream source)
パラメーター
source
Stream
アーカイブのソース。
備考
このコンストラクターは解凍を行いません。解凍のためには Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) メソッドを参照してください。
例外
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
に文字列の途中にコロン (:) が含まれています。
ファイルが見つかりません。
指定されたパスが無効であり、マッピングされていないドライブにある場合などです。
ファイルはすでに開かれています。
メソッド
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"));
}
}
例外
アーカイブヘッダーとサービス情報が読み取られていません。
呼び出し元は fileInfo
を開くための必要な権限を持っていません。
ファイルパスが空であるか、空白のみを含んでいます。
ファイルが見つかりません。
ファイルへのパスが読み取り専用またはディレクトリです。
fileInfo
は null です。
指定されたパスが無効であり、マッピングされていないドライブにある場合などです。
ファイルはすでに開かれています。
Extract(string)
パスによって xz アーカイブをファイルに抽出します。
public FileInfo Extract(string path)
パラメーター
path
string
解凍されたデータを保存するファイルへのパス。
戻り値
抽出されたデータを含む 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
、ファイル名、または両方がシステム定義の最大長を超えています。たとえば、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)
指定されたストリームに 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 文字未満である必要があります。
sourcePath
に文字列の途中にコロン (:) が含まれています。