Language

Encoding.GetEncoder メソッド

定義

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

public:
 virtual System::Text::Encoder ^ GetEncoder();
public virtual System.Text.Encoder GetEncoder();
abstract member GetEncoder : unit -> System.Text.Encoder
override this.GetEncoder : unit -> System.Text.Encoder
Public Overridable Function GetEncoder () As Encoder

返品

Unicode 文字のシーケンスをエンコードされたバイト シーケンスに変換する Encoder 。

注釈

Encoder.GetBytes メソッドは、このクラスの GetBytes メソッドと同様の方法で、文字のシーケンシャル ブロックをバイトのシーケンシャル ブロックに変換します。 ただし、 Encoder は呼び出し間の状態情報を保持するため、ブロックにまたがる文字シーケンスが正しくエンコードされます。 また、 Encoder では、データ ブロックの末尾に末尾の文字が保持され、次のエンコード操作で末尾の文字が使用されます。 たとえば、データ ブロックが一致しない高サロゲートで終わり、一致する低サロゲートが次のデータ ブロックにある可能性があります。 そのため、 GetDecoder と GetEncoder は、ネットワーク転送とファイル操作に役立ちます。これらの操作は、多くの場合、完全なデータ ストリームではなくデータ ブロックを処理するためです。

注意 (継承者)

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

適用対象

こちらもご覧ください