Decoder Класс

Определение

Конвертирует последовательность закодированных байтов в набор символов.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
Наследование
Decoder
Атрибуты

Примеры

В следующем примере показано использование Decoder для преобразования двух различных массивов байтов в массив символов.The following example demonstrates the use of a Decoder to convert two different byte arrays into a character array. Один из байт символов охватывает массивы.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, приложение должно использовать метод GetDecoder реализации Encoding.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.There are several versions of both of these methods available in the Decoder class. Для получения дополнительной информации см. Encoding.GetChars.For more information, see Encoding.GetChars. Объект Decoder хранит сведения о состоянии между последовательными вызовами методов GetChars или Convert, что позволяет правильно декодировать последовательности байтов, охватывающие блоки.A 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. Таким образом, GetDecoder и GetEncoder полезны для передачи по сети и операций с файлами, так как эти операции часто работают с блоками данных, а не с полным потоком данных.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.Initializes a new instance of the Decoder class.

Свойства

Fallback

Получает или задает объект DecoderFallback для текущего объекта Decoder.Gets or sets a DecoderFallback object for the current Decoder object.

FallbackBuffer

Получает объект DecoderFallbackBuffer, связанный с текущим объектом Decoder.Gets the DecoderFallbackBuffer object associated with the current Decoder object.

Методы

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)

Преобразует массив закодированных байтов в символы в кодировке 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)

Преобразует диапазон закодированных байтов в символы в кодировке UTF-16 и сохраняет результат в другом буфере диапазона.Converts a span of encoded bytes to UTF-16 encoded characters and stores the result in another span buffer.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
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)

При переопределении в производном классе вычисляет количество символов, полученных при декодировании последовательности байтов из заданного массива байтов.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)

При переопределении в производном классе вычисляет количество символов, полученных при декодировании последовательности байтов из заданного массива байтов.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)

При переопределении в производном классе вычисляет число символов, полученных при декодировании последовательности байтов в диапазоне.When overridden in a derived class, calculates the number of characters produced by decoding the sequence of bytes in the span. Параметр указывает, следует ли очистить внутреннее состояние декодера после вычисления.A parameter indicates whether to clear the internal state of the decoder after the calculation.

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)

При переопределении в производном классе декодирует последовательность байтов из заданного массива байтов и все байты, расположенные во внутреннем буфере, в указанный массив символов.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)

При переопределении в производном классе декодирует последовательность байтов из заданного массива байтов и все байты, расположенные во внутреннем буфере, в указанный массив символов.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)

При переопределении в производном классе декодирует последовательность байтов из диапазона и все байты во внутреннем буфере в набор символов, которые сохраняются, начиная с заданного указателя символа.When overridden in a derived class, decodes a sequence of span bytes 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.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Reset()

При переопределении в производном классе возвращает декодер в исходное состояние.When overridden in a derived class, sets the decoder back to its initial state.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к

Дополнительно