Class XarArchive

Class XarArchive

名称: Aspose.Zip.Xar 組み合わせ: Aspose.Zip.dll (25.5.0)

このクラスは xar ファイルを表しています。

public class XarArchive : IArchive, IDisposable

Inheritance

object XarArchive

Implements

IArchive , IDisposable

相続人

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

Constructors

XarArchive(XarCompressionSettings)

Aspose.Zip.Xar.XarArchive クラスの新しい例を開始します。

public XarArchive(XarCompressionSettings defaultCompressionSettings = null)

Parameters

defaultCompressionSettings XarCompressionSettings

デフォルトの圧縮設定は、アーカイブのすべてのエントリーに適用されます。

Examples

下記の例では、ファイルを圧縮する方法を示しています。

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

XarArchive(ストリーム、 XarLoadOptions)

Aspose.Zip.Xar.xarArchive クラスの新しい例を開始し、アーカイブから抽出できる入力リストを構成します。

public XarArchive(Stream sourceStream, XarLoadOptions loadOptions = null)

Parameters

sourceStream Stream

アーカイブの情報源は、検索可能でなければならない。

loadOptions XarLoadOptions

アーカイブをアップロードするオプション

Examples

下記の例では、すべての投稿をディレクトリに抽出する方法を示しています。

using (var archive = new XarArchive(File.OpenRead("archive.xar")))
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

このメーカーは、いかなる入り口も取り除くことはありません. Aspose.Zip.Xar.XarFileEntry.Open 方法を参照してください。

Exceptions

ArgumentNullException

sourceStream’ is null.

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

sourceStream’ is not valid xar archive.

XarArchive(シングル, XarLoadOptions)

Aspose.Zip.Xar.xarArchive クラスの新しい例を開始し、アーカイブから抽出できる入力リストを構成します。

public XarArchive(string path, XarLoadOptions loadOptions = null)

Parameters

path string

ファイルへの道のり。

loadOptions XarLoadOptions

アーカイブをアップロードするオプション

Examples

下記の例では、すべての投稿をディレクトリに抽出する方法を示しています。

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

このメーカーは、いかなる入り口も取り除くことはありません. Aspose.Zip.Xar.XarFileEntry.Open 方法を参照してください。

Exceptions

ArgumentNullException

path’ is null.

SecurityException

通話者には、必要なアクセス許可はありません。

ArgumentException

path’ は空っぽで、白いスペースのみが含まれ、または無効な文字が含まれています。

UnauthorizedAccessException

path" ファイルへのアクセスは拒否されます。

PathTooLongException

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

NotSupportedException

path’ のファイルには、列の真ん中のコロン(:)が含まれています。

FileNotFoundException

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

DirectoryNotFoundException

指定されたルートは無効です、例えば、マッピングされていないドライブにあります。

IOException

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

InvalidDataException

path" のファイルは、有効な xar アーカイブではありません。

Properties

Entries

ファイルを構成する Aspose.Zip.Xar.XarEntry タイプのエントリーを取得します。

public IEnumerable<xarentry> Entries { get; }

不動産価値

IEnumerable < XarEntry >

Methods

CreateEntries(ストレッチ, ボール, XarCompressionSettings)

アーカイブにすべてのファイルとディレクトリを繰り返し追加します。

public XarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

sourceDirectory string

コンプレッシャーディレクトリ

includeRootDirectory bool

ルートディレクトリ自体を含むか否かを示す。

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry を追加するために使用された圧縮設定。

Returns

XarArchive

入り口 入り口

Examples

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(@"C:\folder", false);
        archive.Save(xarFile);
    }
}

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

呼び出し者は、 sourceDirectory にアクセスするために必要な許可はありません。

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

例えば、Windows ベースのプラットフォームでは、パスは 248 文字未満で、ファイル名は 260 文字未満でなければなりません。

IOException

sourceDirectory’ stands for a file, not for a directory.

CreateEntries(DirectoryInfo, ボール, XarCompressionSettings)

アーカイブにすべてのファイルとディレクトリを繰り返し追加します。

public XarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true, XarCompressionSettings compressionSettings = null)

Parameters

directory DirectoryInfo

コンプレッシャーディレクトリ

includeRootDirectory bool

ルートディレクトリ自体を含むか否かを示す。

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry を追加するために使用された圧縮設定。

Returns

XarArchive

入り口 入り口

Examples

using (FileStream xarFile = File.Open("archive.xar", FileMode.Create))
{
    using (var archive = new XarArchive())
    {
        archive.CreateEntries(new DirectoryInfo(@"C:\folder"), false);
        archive.Save(xarFile);
    }
}

Exceptions

ArgumentNullException

directory’ is null.

SecurityException

通話者は、コードクラス=“paramref”>ディレクトリにアクセスするために必要な許可はありません。

IOException

directory’ stands for a file, not for a directory.

CreateEntry(ストレッチ, FileInfo, bool, XarCompressionSettings)

ファイル内で単一のエントリーを作成します。

public XarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

入り口の名前。

fileInfo FileInfo

ファイルまたはフォルダーのメタデータが圧縮される。

openImmediately bool

確かに、すぐにファイルを開く場合は、ファイルをアーカイブ保存で開きます。

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry を追加するために使用された圧縮設定。

Returns

XarEntry

入り口 入り口

Examples

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new XarArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.xar");
}

Remarks

ファイルがパラメーターで直ちに開く場合は、アーカイブが解除されるまでブロックされます。

Exceptions

ArgumentNullException

name’ is null.

ArgumentException

name’ is empty.

ArgumentNullException

fileInfo’ is null.

CreateEntry(ストリップ、ストリップ、ボール、 XarCompressionSettings)

ファイル内で単一のエントリーを作成します。

public XarEntry CreateEntry(string name, string sourcePath, bool openImmediately = false, XarCompressionSettings compressionSettings = null)

Parameters

name string

入り口の名前。

sourcePath string

ファイルを圧縮する方法

openImmediately bool

確かに、すぐにファイルを開く場合は、ファイルをアーカイブ保存で開きます。

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry を追加するために使用された圧縮設定。

Returns

XarEntry

入り口 入り口

Examples

using (var archive = new XarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.xar");
}

Remarks

入力名はパラメーター内でのみ設定されます. パラメーターで提供されたファイル名は、入力名に影響を与えません。

ファイルがパラメーターで直ちに開く場合は、アーカイブが解除されるまでブロックされます。

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

通話者には、必要なアクセス許可はありません。

ArgumentException

sourcePath’ は空っぽで、白いスペースのみが含まれ、または無効な文字が含まれています. - または - ファイル名は、 name’ の部分として、100 シンボルを超えています。

UnauthorizedAccessException

ファイルへのアクセス sourcePath’ は拒否されます。

PathTooLongException

例えば、Windows ベースのプラットフォームでは、パスは 248 文字未満で、ファイル名は 260 文字未満でなければなりません。

NotSupportedException

sourcePath’ のファイルには、列の真ん中のコロン(:)が含まれています。

InvalidOperationException

シルアーカイブを変更することはできません。

CreateEntry(ストリーム, ストリーム, XarCompressionSettings)

ファイル内で単一のエントリーを作成します。

public XarEntry CreateEntry(string name, Stream source, XarCompressionSettings compressionSettings = null)

Parameters

name string

入り口の名前。

source Stream

入り口への入り口の流れ

compressionSettings XarCompressionSettings

Aspose.Zip.Xar.XarEntry を追加するために使用された圧縮設定。

Returns

XarEntry

入り口 入り口

Examples

using (var archive = new XarArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.xar");
}

Exceptions

ArgumentNullException

name’ is null.

ArgumentNullException

source’ is null.

ArgumentException

name’ is empty.

InvalidOperationException

シルアーカイブを変更することはできません。

DeleteEntry(XarEntry)

入力リストから特定の入力の最初の発生を削除します。

public XarArchive DeleteEntry(XarEntry entry)

Parameters

entry XarEntry

入力リストから削除するための入力。

Returns

XarArchive

入り口 入り口

Examples

以下は、最後の1を除くすべての投稿を削除する方法です。

using (var archive = new XarArchive("archive.xar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries.FirstOrDefault());
    archive.Save(outputXarFile);
}

Exceptions

ArgumentNullException

entry’ is null.

Dispose()

応用によって定義された課題を実行し、未管理資源のリリース、リリース、またはリセットに関連しています。

public void Dispose()

Dispose(ボール)

応用によって定義された課題を実行し、未管理資源のリリース、リリース、またはリセットに関連しています。

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

管理された資源は削除されるべきである。

ExtractToDirectory(ストレッチ)

アーカイブのすべてのファイルを提供されたディレクトリに抽出します。

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

引き出されたファイルを入力するためのディレクトリへのルート。

Examples

using (var archive = new XarArchive("archive.xar")) 
{
   archive.ExtractToDirectory("C:\\extracted");
}

Remarks

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

Exceptions

ArgumentNullException

道はゼロ

PathTooLongException

例えば、Windows ベースのプラットフォームでは、パスは 248 文字未満で、ファイル名は 260 文字未満でなければなりません。

SecurityException

通話者は、既存のディレクトリにアクセスするための必要な許可はありません。

NotSupportedException

ディレクトリが存在しない場合、コースには、ドライブラベル(「C:」)の一部ではないコロン キャラクター(:)が含まれています。

ArgumentException

路線はゼロ長さの線であり、白い空間のみを含み、あるいは1つまたは複数の無効な文字を含みます。 無効な文字は、System.IO.Path.GetInvalidPathChars メソッドを使用してリクエストできます。

IOException

ルートによって指定されたディレクトリはファイルです. -or- ネットワーク名は知られていません。

InvalidDataException

アーカイブが腐敗した。

Save(シングル, XarSaveOptions)

提供された目的地ファイルにアーカイブを保存します。

public void Save(string destinationFileName, XarSaveOptions saveOptions = null)

Parameters

destinationFileName string

ファイル名が既存のファイルを指定した場合、それは書き換えられます。

saveOptions XarSaveOptions

ソーシャルアーカイブを保存するオプション

Exceptions

ArgumentNullException

destinationFileName’ is null.

InvalidOperationException

シルアーカイブを変更することはできません。

Save(ストリーム, XarSaveOptions)

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

public void Save(Stream output, XarSaveOptions saveOptions = null)

Parameters

output Stream

目的地の流れ

saveOptions XarSaveOptions

ソーシャルアーカイブを保存するオプション

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’Is not writable/readable or not seekable.

InvalidOperationException

シルアーカイブを変更することはできません。

 日本語