UTF8Encoding.GetDecoder Метод

Определение

Пространство имен:
System.Text
Сборки:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Сборки:
netstandard.dll, System.Text.Encoding.Extensions.dll
Сборка:
System.Text.Encoding.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
UTF8Encoding.cs
Исходный код:
UTF8Encoding.cs
Исходный код:
UTF8Encoding.cs
Исходный код:
UTF8Encoding.cs
Исходный код:
UTF8Encoding.cs

Получает декодатор, который преобразует кодировку UTF-8 байтов в последовательность символов Юникода.

public:
 override System::Text::Decoder ^ GetDecoder();
public override System.Text.Decoder GetDecoder();
override this.GetDecoder : unit -> System.Text.Decoder
Public Overrides Function GetDecoder () As Decoder

Возвращаемое значение

Decoder

Декодировщик, который преобразует закодированную последовательность байтов UTF-8 в последовательность символов Юникода.

Примеры

В следующем примере метод используется GetDecoder для получения декодатора UTF-8. Декодатор преобразует последовательность байтов в последовательность символов.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            99, 204, 128, 234, 130, 160
        };

        Decoder utf8Decoder = Encoding.UTF8.GetDecoder();

        int charCount = utf8Decoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = utf8Decoder.GetChars(bytes, 0, bytes.Length, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = {99, 204, 128, 234, 130, 160}
        
        Dim utf8Decoder As Decoder = Encoding.UTF8.GetDecoder()
        
        Dim charCount As Integer = utf8Decoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf8Decoder.GetChars( _
            bytes, 0, bytes.Length, chars, 0 _
        )
        
        Console.WriteLine("{0} characters used to decode bytes.", charsDecodedCount)
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

Комментарии

Метод Decoder.GetChars преобразует последовательные блоки байтов в последовательные блоки символов, аналогично методу GetChars этого класса. Однако между вызовами сохраняется информация о состоянии, Decoder поэтому она может правильно декодировать последовательности байтов, охватывающие блоки. Он Decoder также сохраняет конечные байты в конце блоков данных и использует конечные байты в следующей операции декодирования. Таким образом, GetDecoder и GetEncoder они полезны для сетевых операций передачи и файлов, так как эти операции часто имеют дело с блоками данных вместо полного потока данных.

Если включено обнаружение ошибок, то throwOnInvalidCharacters есть параметр конструктора имеет trueзначение, обнаружение ошибок также включено в Decoder возвращаемом этим методом. Если обнаружена ошибка и обнаружена недопустимая последовательность, состояние декодера не определено и обработка должна остановиться.

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

См. также раздел