Encoding.GetEncoder メソッド

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

Encoding.GetEncoder メソッド

派生クラスでオーバーライドされた場合、Unicode 文字のシーケンスをエンコード済みバイト シーケンスに変換するエンコーダを取得します。

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

Visual Basic (宣言)

Public Overridable Function
 GetEncoder As Encoder

Visual Basic (使用法)

Dim instance As Encoding
Dim returnValue As Encoder

returnValue = instance.GetEncoder

C#

public virtual Encoder GetEncoder ()

C++

public:
virtual Encoder^ GetEncoder ()

J#

public Encoder GetEncoder ()

JScript

public function GetEncoder () : Encoder

戻り値
Unicode 文字のシーケンスをエンコード済みバイト シーケンスに変換する Encoder。

解説

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

実装時の注意 既定の実装では、現在の Encoding の GetByteCount メソッドと GetBytes メソッドを呼び出すだけの Encoder が返されます。呼び出し間で状態を維持する Encoder を取得するには、このメソッドをオーバーライドする必要があります。

プラットフォーム

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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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