Decoder.Reset メソッド

.NET Framework クラス ライブラリ リファレンス

Decoder.Reset メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

派生クラスでオーバーライドされた場合、デコーダを初期状態に戻します。

名前空間: System.Text
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Overridable Sub Reset

Visual Basic (使用法)

Dim instance As Decoder

instance.Reset

C#

[ComVisibleAttribute(false)] 
public virtual void Reset ()

C++

[ComVisibleAttribute(false)] 
public:
virtual void Reset ()

J#

/** @attribute ComVisibleAttribute(false) */ 
public void Reset ()

JScript

ComVisibleAttribute(false) 
public function Reset ()

解説

Decoder オブジェクトでは、複数のブロックにまたがるバイト シーケンスを正確にデコードできるように、GetChars への連続する呼び出し間でステータス情報を維持します。また、Decoder オブジェクトは、データ ブロックの末尾で後続バイトを保持し、その後続バイトを次のデコード操作に使用します。したがって、GetDecoder と GetEncoder は、ネットワーク伝送やファイル操作に役立ちます。これは、ネットワーク伝送やファイル操作では、完全なデータ ストリームではなくデータのブロックを処理することが多いためです。

Reset は、GetChars への前の呼び出しから保持されているステータス情報 (前のデータ ブロックの末尾にある後続バイトを含む) をクリアします。

Reset は、GetChars または GetCharCount によって例外がスローされた後も同じデコーダを再利用する場合に便利です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Decoder クラス
Decoder メンバ
System.Text 名前空間