Decoder クラス

定義

public ref class Decoder abstract

public abstract class Decoder

[System.Serializable]
public abstract class Decoder

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Decoder

type Decoder = class

[<System.Serializable>]
type Decoder = class

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Decoder = class

Public MustInherit Class Decoder

継承

Object

Decoder

属性

SerializableAttribute ComVisibleAttribute

例

次の例では、 Decoder を使用して 2 つの異なるバイト配列を文字配列に変換する方法を示します。 文字のバイトの 1 つが配列にまたがっています。 これは、ストリームを読み取るときに StreamReader オブジェクトが内部的に行うのと似ています。

using System;
using System.Text;
public class dec
{
    public static void Main()
    {
        // These bytes in UTF-8 correspond to 3 different Unicode
        // characters: space (U+0020), # (U+0023), and the biohazard
        // symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        // in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        // multiple calls to GetChars, handling the case when one char
        // is in multiple byte arrays.
        byte[] bytes1 = { 0x20, 0x23, 0xe2 };
        byte[] bytes2 = { 0x98, 0xa3 };
        char[] chars = new char[3];

        Decoder d = Encoding.UTF8.GetDecoder();
        int charLen = d.GetChars(bytes1, 0, bytes1.Length, chars, 0);
        // The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen);
        foreach(char c in chars)
            Console.Write("U+{0:X4}  ", (ushort)c);
    }
}

Imports System.Text

Public Class dec
    
    Public Shared Sub Main()
        ' These bytes in UTF-8 correspond to 3 different Unicode
        ' characters: space (U+0020), # (U+0023), and the biohazard
        ' symbol (U+2623).  Note the biohazard symbol requires 3 bytes
        ' in UTF-8 (hexadecimal e2, 98, a3).  Decoders store state across
        ' multiple calls to GetChars, handling the case when one char
        ' is in multiple byte arrays.
        Dim bytes1 As Byte() =  {&H20, &H23, &HE2}
        Dim bytes2 As Byte() =  {&H98, &HA3}
        Dim chars(3) As Char
        
        Dim d As Decoder = Encoding.UTF8.GetDecoder()
        Dim charLen As Integer = d.GetChars(bytes1, 0, bytes1.Length, chars, 0)
        ' The value of charLen should be 2 now.
        charLen += d.GetChars(bytes2, 0, bytes2.Length, chars, charLen)
        Dim c As Char
        For Each c In  chars
            Console.Write("U+{0:X4}  ", Convert.ToUInt16(c) )
        Next c
    End Sub
End Class

注釈

Decoder クラスの実装のインスタンスを取得するには、Encoding実装のGetDecoder メソッドを呼び出します。

GetCharCount メソッドは、バイト シーケンスをデコードする結果の文字数を決定し、GetChars メソッドは実際のデコードを実行します。 Decoder クラスでは、これらの両方のメソッドのいくつかのバージョンを使用できます。 詳細については、Encoding.GetCharsを参照してください。 Decoder オブジェクトは、GetCharsメソッドまたはConvert メソッドの連続する呼び出し間で状態情報を保持するため、ブロックにまたがるバイト シーケンスを正しくデコードできます。 Decoderでは、データ ブロックの末尾にある末尾のバイトも保持され、次のデコード操作で末尾のバイトが使用されます。 そのため、 GetDecoder と GetEncoder は、ネットワーク転送とファイル操作に役立ちます。これらの操作は、完全なデータ ストリームではなく、データ ブロックを処理することが多いためです。

注意 (実装者)

アプリケーションがこのクラスから継承する場合は、すべてのメンバーをオーバーライドする必要があります。

こちらもご覧ください

• Encoder
• Encoding
• GetChars(Byte[], Int32, Int32)
• エンコーディングについて