Class ZstandardArchive

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

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

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

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

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

`Methods`

`Dispose()`

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

public void Dispose()

`Dispose(ボール)`

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

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

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

`Extract(Stream)`

提供された流れにアーカイブを抽出します。

public void Extract(Stream destination)

`Parameters`

destination Stream

目的地の流れは、書くべきです。

`Examples`

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

`Extract(ストレッチ)`

ファイルを経由でファイルに抽出します。

public FileInfo Extract(string path)

`Parameters`

path string

ターゲットファイルへのルート. ファイルが既に存在している場合、それは過剰に書かれます。

`Returns`

FileInfo

抽出されたファイルの情報

`Exceptions`

path’ is null.

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

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

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

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

`ExtractToDirectory(ストレッチ)`

提供されたディレクトリにアーカイブのコンテンツを抽出します。

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

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

`Remarks`

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

`Exceptions`

destinationDirectory’ is null.

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

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

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

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

`Open()`

抽出のためのアーカイブを開き、アーカイブコンテンツの流れを提供します。

public Stream Open()

`Returns`

Stream

アーカイブの内容を表す流れ。

`Examples`

アーカイブを抽出し、抽出されたコンテンツをファイルストリームにコピーします。

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Stream.CopyTo を使用して .NET 4.0 またはそれ以上の方法を使用する場合があります: unpacked.Kopy To(抽出);

`Remarks`

ストリームから読んでファイルのオリジナルコンテンツを取得します。

`Save(ストリーム、ZstandardSaveOptions)`

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

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

`Parameters`

outputStream Stream

目的地の流れ

settings ZstandardSaveOptions

アーカイブ構成のオプション設定

`Examples`

圧縮されたデータを http 応答ストリームに書き込む。

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

`Remarks`

書くべきである。

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

源は提供されていません。

`Save(ストレッチ、ZstandardSaveOptions)`

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

public void Save(string destinationFileName, ZstandardSaveOptions settings = null)

`Parameters`

destinationFileName string

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

settings ZstandardSaveOptions

アーカイブ構成のオプション設定

`Examples`

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

`Exceptions`

destinationFileName’ is null.

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

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

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

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

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

`Save(FileInfo、ZstandardSaveオプション)`

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

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

`Parameters`

destination FileInfo

FileInfo、目的地ストリームとして開きます。

settings ZstandardSaveOptions

アーカイブ構成のオプション設定

`Examples`

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

`Exceptions`

通話者は、 destination を開くために必要な許可はありません。

ファイルパスは空いているか、白いスペースのみが含まれています。

FileNotFoundException

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

ファイルへの道は単なる読み方であるか、またはディレクトリである。

DirectoryNotFoundException

destination’ is null.

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

IOException

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

`SetSource(Stream)`

コンテンツをファイル内で圧縮するように設定します。

public void SetSource(Stream source)

`Parameters`

source Stream

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

`Examples`

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

`SetSource(FileInfo)`

コンテンツをファイル内で圧縮するように設定します。

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

圧縮されるファイルへの参照

`Examples`

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

`SetSource(ストレッチ)`

コンテンツをファイル内で圧縮するように設定します。

public void SetSource(string path)

`Parameters`

path string

ファイルを圧縮する方法

`Examples`

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

`Exceptions`

path’ is null.

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

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

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