UTF8Encoding.GetEncoder メソッド

定義

名前空間:

System.Text

アセンブリ:

netstandard.dll, System.Text.Encoding.Extensions.dll

ソース:

UTF8Encoding.cs

Unicode 文字のシーケンスを UTF-8 でエンコードされたバイト シーケンスに変換するエンコーダーを取得します。

C#

public override System.Text.Encoder GetEncoder();

戻り値

Encoder

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

例

次の例では、 メソッドを GetEncoder 使用してエンコーダーを取得し、一連の文字を UTF-8 でエンコードされたバイト シーケンスに変換します。

C#

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Char[] chars = new Char[] {'a', 'b', 'c', '\u0300', '\ua0a0'};
        Byte[] bytes;

        Encoder utf8Encoder = Encoding.UTF8.GetEncoder();

        int byteCount = utf8Encoder.GetByteCount(chars, 2, 3, true);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = utf8Encoder.GetBytes(chars, 2, 3, bytes, 0, true);

        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

注釈

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

エラー検出が有効になっている場合、つまり、 throwOnInvalidCharacters コンストラクターのパラメーターが に true設定されている場合、このメソッドによって返される でも Encoder エラー検出が有効になります。 エラー検出が有効で、無効なシーケンスが検出された場合、エンコーダーの状態は未定義であり、処理を停止する必要があります。

適用対象

こちらもご覧ください

• Encoder
• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetDecoder()
• エンコーディングについて