Decoder Decoder Decoder Decoder Class

定義

エンコード済みバイト シーケンスを文字のセットに変換します。Converts a sequence of encoded bytes into a set of characters.

public ref class Decoder abstract
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Decoder
type Decoder = class
Public MustInherit Class Decoder
継承
DecoderDecoderDecoderDecoder
属性

次の例は、をDecoder使用して、2つの異なるバイト配列を文字配列に変換する方法を示しています。The following example demonstrates the use of a Decoder to convert two different byte arrays into a character array. 文字のバイトの1つが配列にまたがります。One of the character's bytes spans the arrays. これは、ストリームを読み取るStreamReaderときに、オブジェクトが内部で行う処理に似ています。This is similar to what a StreamReader object does internally when reading a stream.

using namespace System;
using namespace System::Text;
int 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.
   array<Byte>^bytes1 = {0x20,0x23,0xe2};
   array<Byte>^bytes2 = {0x98,0xa3};
   array<Char>^chars = gcnew array<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 );
   for ( UInt16 index(0); index < chars->Length; ++index )
   {
      Console::Write( "U+{0:X4}  ", static_cast<UInt16>(chars[ index ]) );

   }
}

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メソッドを使用する必要があります。To obtain an instance of an implementation of the Decoder class, the application should use the GetDecoder method of an Encoding implementation.

メソッドGetCharCountは、バイトシーケンスをデコードする文字数を決定し、メソッドはGetChars実際のデコードを実行します。The GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars method performs the actual decoding. クラスでは、 Decoderこれら2つのメソッドの両方のバージョンを使用できます。There are several versions of both of these methods available in the Decoder class. 詳細については、「Encoding.GetChars」を参照してください。For more information, see Encoding.GetChars. オブジェクトは、またはConvertメソッドのGetChars連続呼び出しの間で状態情報を保持するため、ブロックにまたがるバイトシーケンスを正しくデコードできます。 DecoderA Decoder object maintains state information between successive calls to GetChars or Convert methods so it can correctly decode byte sequences that span blocks. またDecoder 、は、データブロックの末尾で末尾のバイトを保持し、次のデコード操作で末尾のバイトを使用します。The Decoder also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. そのためGetDecoderGetEncoderとは、ネットワークの転送およびファイル操作に役立ちます。これらの操作は、多くの場合、完全なデータストリームではなく、データのブロックを処理するからです。Therefore, GetDecoder and GetEncoder are useful for network transmission and file operations because those operations often deal with blocks of data instead of a complete data stream.

注意

データストリームを使用してアプリケーションを実行する場合は、適切なメソッド呼び出しでflushパラメーターをに設定するtrueことによって、状態情報がフラッシュされるようにする必要があります。When the application is done with a stream of data, it should make sure that the state information is flushed by setting the flush parameter to true in the appropriate method call. 例外が発生した場合、またはアプリケーションがストリームを切り替えるReset場合は、を呼び出して、 Decoderオブジェクトの内部状態をクリアする必要があります。If an exception occurs or if the application switches streams, it should call Reset to clear the internal state of the Decoder object.

バージョンに関する考慮事項Version Considerations

変換Decoder操作Encoder中に、オブジェクトまたはオブジェクトをシリアル化できます。A Decoder or Encoder object can be serialized during a conversion operation. オブジェクトの状態は、同じバージョンの .NET Framework で逆シリアル化された場合は保持されますが、別のバージョンで逆シリアル化された場合は失われます。The state of the object is retained if it is deserialized in the same version of the .NET Framework, but lost if it is deserialized in another version.

注意 (継承者)

アプリケーションがこのクラスから継承する場合は、すべてのメンバーをオーバーライドする必要があります。When your application inherits from this class, it must override all the members.

コンストラクター

Decoder() Decoder() Decoder() Decoder()

Decoder クラスの新しいインスタンスを初期化します。Initializes a new instance of the Decoder class.

プロパティ

Fallback Fallback Fallback Fallback

現在の DecoderFallback オブジェクトの Decoder オブジェクトを取得または設定します。Gets or sets a DecoderFallback object for the current Decoder object.

FallbackBuffer FallbackBuffer FallbackBuffer FallbackBuffer

現在の DecoderFallbackBuffer オブジェクトに関連付けられている Decoder オブジェクトを取得します。Gets the DecoderFallbackBuffer object associated with the current Decoder object.

メソッド

Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean) Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean) Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean) Convert(Byte*, Int32, Char*, Int32, Boolean, Int32, Int32, Boolean)

バッファーに格納されているエンコード済みバイトを UTF-16 エンコード文字に変換し、その結果を別のバッファーに格納します。Converts a buffer of encoded bytes to UTF-16 encoded characters and stores the result in another buffer.

Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean) Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean) Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean) Convert(Byte[], Int32, Int32, Char[], Int32, Int32, Boolean, Int32, Int32, Boolean)

配列に格納されているエンコード済みバイトを UTF-16 エンコード文字に変換し、その結果を文字配列に格納します。Converts an array of encoded bytes to UTF-16 encoded characters and stores the result in a character array.

Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean) Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean) Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean) Convert(ReadOnlySpan<Byte>, Span<Char>, Boolean, Int32, Int32, Boolean)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCharCount(Byte*, Int32, Boolean) GetCharCount(Byte*, Int32, Boolean) GetCharCount(Byte*, Int32, Boolean) GetCharCount(Byte*, Int32, Boolean)

派生クラスでオーバーライドされた場合、指定したバイト ポインターから始まるバイト シーケンスをデコードすることによって生成される文字数を計算します。When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer. パラメーターは、計算後に、デコーダーの内部状態をクリアするかどうかを示します。A parameter indicates whether to clear the internal state of the decoder after the calculation.

GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32) GetCharCount(Byte[], Int32, Int32)

派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンスをデコードすることによって生成される文字数を計算します。When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.

GetCharCount(Byte[], Int32, Int32, Boolean) GetCharCount(Byte[], Int32, Int32, Boolean) GetCharCount(Byte[], Int32, Int32, Boolean) GetCharCount(Byte[], Int32, Int32, Boolean)

派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンスをデコードすることによって生成される文字数を計算します。When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. パラメーターは、計算後に、デコーダーの内部状態をクリアするかどうかを示します。A parameter indicates whether to clear the internal state of the decoder after the calculation.

GetCharCount(ReadOnlySpan<Byte>, Boolean) GetCharCount(ReadOnlySpan<Byte>, Boolean) GetCharCount(ReadOnlySpan<Byte>, Boolean) GetCharCount(ReadOnlySpan<Byte>, Boolean)
GetChars(Byte*, Int32, Char*, Int32, Boolean) GetChars(Byte*, Int32, Char*, Int32, Boolean) GetChars(Byte*, Int32, Char*, Int32, Boolean) GetChars(Byte*, Int32, Char*, Int32, Boolean)

派生クラスでオーバーライドされた場合、指定したバイト ポインターで始まるバイト シーケンス、および内部バッファー内のバイトを、指定した文字ポインターを開始位置として格納される文字のセットにエンコードします。When overridden in a derived class, decodes a sequence of bytes starting at the specified byte pointer and any bytes in the internal buffer into a set of characters that are stored starting at the specified character pointer. パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。A parameter indicates whether to clear the internal state of the decoder after the conversion.

GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32) GetChars(Byte[], Int32, Int32, Char[], Int32)

派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンス、および内部バッファー内のバイトを、指定した文字配列にデコードします。When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array.

GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean) GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean) GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean) GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)

派生クラスでオーバーライドされた場合、指定したバイト配列に格納されているバイト シーケンス、および内部バッファー内のバイトを、指定した文字配列にデコードします。When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array. パラメーターでは、変換後にデコーダーの内部状態をクリアするかどうかを示します。A parameter indicates whether to clear the internal state of the decoder after the conversion.

GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean) GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean) GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean) GetChars(ReadOnlySpan<Byte>, Span<Char>, Boolean)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Reset() Reset() Reset() Reset()

派生クラスでオーバーライドされた場合、デコーダーを初期状態に戻します。When overridden in a derived class, sets the decoder back to its initial state.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

適用対象

こちらもご覧ください