Encoding.GetEncoder メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
派生クラスでオーバーライドされると、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.EncoderPublic Overridable Function GetEncoder () As Encoder返品
Unicode 文字のシーケンスをエンコードされたバイト シーケンスに変換する Encoder 。
注釈
Encoder.GetBytes メソッドは、このクラスの GetBytes メソッドと同様の方法で、文字のシーケンシャル ブロックをバイトのシーケンシャル ブロックに変換します。 ただし、 Encoder は呼び出し間の状態情報を保持するため、ブロックにまたがる文字シーケンスが正しくエンコードされます。 また、 Encoder では、データ ブロックの末尾に末尾の文字が保持され、次のエンコード操作で末尾の文字が使用されます。 たとえば、データ ブロックが一致しない高サロゲートで終わり、一致する低サロゲートが次のデータ ブロックにある可能性があります。 そのため、 GetDecoder と GetEncoder は、ネットワーク転送とファイル操作に役立ちます。これらの操作は、多くの場合、完全なデータ ストリームではなくデータ ブロックを処理するためです。
注意 (継承者)
既定の実装では、現在のEncodingのGetByteCount(Char[])メソッドとGetBytes(Char[]) メソッドを呼び出すEncoderが返されます。 呼び出し間で状態を維持する Encoder を返すには、このメソッドをオーバーライドする必要があります。