Encoder.Reset メソッド

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

Encoder.Reset メソッド

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

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

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Overridable Sub Reset

Visual Basic (使用法)

Dim instance As Encoder

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 ()

解説

Encoder オブジェクトは、複数のブロックにまたがる文字シーケンスを正確にエンコードできるように、GetBytes への連続する呼び出し間でステータス情報を維持します。また、Encoder オブジェクトは、データ ブロックの末尾で後続文字を保持し、その後続文字を次のエンコード操作に使用します。たとえば、データ ブロックが上位サロゲートで終了し、対応する下位サロゲートが次のデータ ブロックに含まれる場合があります。したがって、Decoder クラスと Encoder クラスは、ネットワーク伝送やファイル操作に役立ちます。これは、ネットワーク伝送やファイル操作では、完全なデータ ストリームではなくデータのブロックを処理することが多いためです。

Reset は、GetBytes への前の呼び出しから保持されているステータス情報 (下位サロゲートのない上位サロゲートなど、前のデータ ブロックの末尾にある後続文字を含む) をクリアします。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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