Decoder Klasse

Definition

Konvertiert eine Folge codierter Bytes in Zeichen.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
Vererbung
Decoder
Attribute

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung von Decoder , um zwei verschiedene Byte Arrays in ein Zeichen Array zu konvertieren.The following example demonstrates the use of a Decoder to convert two different byte arrays into a character array. Eines der Bytes des Zeichens umfasst die Arrays.One of the character's bytes spans the arrays. Dies ähnelt dem internen Vorgang eines StreamReader -Objekts beim Lesen eines Streams.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

Hinweise

Um eine Instanz einer Implementierung der Decoder -Klasse zu erhalten, sollte die Anwendung die GetDecoder -Methode Encoding einer-Implementierung verwenden.To obtain an instance of an implementation of the Decoder class, the application should use the GetDecoder method of an Encoding implementation.

Die GetCharCount -Methode bestimmt, wie viele Zeichen beim Decodieren einer Bytefolge resultieren GetChars , und die-Methode führt die eigentliche Decodierung aus.The GetCharCount method determines how many characters result in decoding a sequence of bytes, and the GetChars method performs the actual decoding. Es gibt mehrere Versionen beider Methoden, die in der Decoder -Klasse verfügbar sind.There are several versions of both of these methods available in the Decoder class. Weitere Informationen finden Sie unter Encoding.GetChars.For more information, see Encoding.GetChars. Ein Decoder -Objekt verwaltet Zustandsinformationen zwischen aufeinander folgenden GetChars aufrufen Convert von-oder-Methoden, sodass Byte Sequenzen, die Blöcke spannen, ordnungsgemäß decodiert werden können.A Decoder object maintains state information between successive calls to GetChars or Convert methods so it can correctly decode byte sequences that span blocks. Behält Decoder auch nachfolgende Bytes am Ende der Datenblöcke bei und verwendet die nachfolgenden Bytes im nächsten Decodierungs Vorgang.The Decoder also preserves trailing bytes at the end of data blocks and uses the trailing bytes in the next decoding operation. Daher sind GetDecoder und GetEncoder für Netzwerk Übertragungs-und Datei Vorgänge nützlich, da diese Vorgänge häufig Datenblöcke anstelle eines gesamten Datenstroms behandeln.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.

Hinweis

Wenn die Anwendung mit einem Datenstrom ausgeführt wird, sollte sichergestellt werden, dass die Zustandsinformationen geleert werden, indem der flush -Parameter im entsprechenden Methoden aufrufauf auf true festgelegt wird.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. Wenn eine Ausnahme auftritt oder die Anwendung Datenströme schaltet, sollte aufgerufen Reset werden, um den internen Status Decoder des Objekts zu löschen.If an exception occurs or if the application switches streams, it should call Reset to clear the internal state of the Decoder object.

Überlegungen zur VersionVersion Considerations

Ein Decoder - Encoder oder-Objekt kann während eines Konvertierungs Vorgangs serialisiert werden.A Decoder or Encoder object can be serialized during a conversion operation. Der Status des Objekts wird beibehalten, wenn es in derselben Version des .NET Framework deserialisiert wird, aber verloren gegangen ist, wenn es in einer anderen Version deserialisiert wird.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.

Hinweise für Ausführende

Wenn Ihre Anwendung von dieser Klasse erbt, muss Sie alle Member überschreiben.When your application inherits from this class, it must override all the members.

Konstruktoren

Decoder()

Initialisiert eine neue Instanz der Decoder-Klasse.Initializes a new instance of the Decoder class.

Eigenschaften

Fallback

Ruft ein DecoderFallback-Objekt für das aktuelle Decoder-Objekt ab oder legt es fest.Gets or sets a DecoderFallback object for the current Decoder object.

FallbackBuffer

Ruft das DecoderFallbackBuffer-Objekt ab, das dem aktuellen Decoder-Objekt zugeordnet ist.Gets the DecoderFallbackBuffer object associated with the current Decoder object.

Methoden

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

Konvertiert einen Puffer codierter Bytes in UTF-16-codierte Zeichen und speichert das Ergebnis in einem anderen Puffer.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)

Konvertiert ein Array codierter Bytes in UTF-16-codierte Zeichen und speichert das Ergebnis in einem Zeichenarray.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)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetCharCount(Byte*, Int32, Boolean)

Berechnet beim Überschreiben in einer abgeleiteten Klasse die Anzahl der Zeichen, die beim Decodieren einer Bytefolge ab dem angegebenen Bytezeiger erzeugt werden.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Kalkulation gelöscht werden soll.A parameter indicates whether to clear the internal state of the decoder after the calculation.

GetCharCount(Byte[], Int32, Int32)

Berechnet beim Überschreiben in einer abgeleiteten Klasse die Anzahl der Zeichen, die beim Decodieren einer Bytefolge aus dem angegebenen Bytearray erzeugt werden.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)

Berechnet beim Überschreiben in einer abgeleiteten Klasse die Anzahl der Zeichen, die beim Decodieren einer Bytefolge aus dem angegebenen Bytearray erzeugt werden.When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Kalkulation gelöscht werden soll.A parameter indicates whether to clear the internal state of the decoder after the calculation.

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

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge beginnend am angegebenen Bytezeiger einschließlich aller Bytes im internen Puffer in Zeichen decodiert, die ab Beginn des angegebenen Zeichenzeigers gespeichert werden.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. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.A parameter indicates whether to clear the internal state of the decoder after the conversion.

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

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge aus dem angegebenen Bytearray einschließlich aller Bytes im internen Puffer in das angegebene Zeichenarray decodiert.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)

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge aus dem angegebenen Bytearray einschließlich aller Bytes im internen Puffer in das angegebene Zeichenarray decodiert.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. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.A parameter indicates whether to clear the internal state of the decoder after the conversion.

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

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
Reset()

Beim Überschreiben in einer abgeleiteten Klasse wird der Decoder in den Anfangszustand zurückversetzt.When overridden in a derived class, sets the decoder back to its initial state.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch