Decoder Klas

Definitie

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

Overname

Object

Decoder

Kenmerken

SerializableAttribute ComVisibleAttribute

Voorbeelden

In het volgende voorbeeld ziet u het gebruik van een Decoder om twee verschillende bytematrices te converteren naar een tekenmatrix. Een van de bytes van het teken omvat de matrices. Dit is vergelijkbaar met wat een StreamReader object intern doet bij het lezen van een stream.

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

Opmerkingen

Als u een exemplaar van een implementatie van de Decoder klasse wilt verkrijgen, roept u de GetDecoder methode van een Encoding implementatie aan.

De GetCharCount methode bepaalt hoeveel tekens resulteren in het decoderen van een reeks bytes en de GetChars methode voert de daadwerkelijke decodering uit. Er zijn verschillende versies van beide methoden beschikbaar in de Decoder klasse. Zie Encoding.GetChars voor meer informatie. Een Decoder object onderhoudt statusinformatie tussen opeenvolgende aanroepen of GetCharsConvert methoden, zodat bytereeksen die blokken omvatten, correct kunnen decoderen. Het Decoder behoudt ook volgbytes aan het einde van gegevensblokken en gebruikt de volgbytes in de volgende decoderingsbewerking. GetDecoder Daarom, en GetEncoder zijn nuttig voor netwerkoverdracht en bestandsbewerkingen omdat deze bewerkingen vaak omgaan met blokken gegevens in plaats van een volledige gegevensstroom.

Notities voor uitvoerders

Wanneer uw toepassing wordt overgenomen van deze klasse, moet deze alle leden overschrijven.

Zie ook

• Encoder
• Encoding
• GetChars(Byte[], Int32, Int32)
• Informatie over coderingen