ASCIIEncoding.GetChars Метод

Определение

Пространство имен:

System.Text

Сборки:

netstandard.dll, System.Text.Encoding.Extensions.dll

Декодирует последовательность байтов в набор символов.

Перегрузки

Имя	Описание
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Декодирует указанный диапазон байтов в указанный диапазон символов.
GetChars(Byte*, Int32, Char*, Int32)	Декодирует последовательность байтов, начиная с указанного указателя байтов, в набор символов, хранящихся начиная с указанного указателя символов.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Декодирует последовательность байтов из указанного массива байтов в указанный массив символов.

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

Исходный код:

ASCIIEncoding.cs

Декодирует указанный диапазон байтов в указанный диапазон символов.

public:
 override int GetChars(ReadOnlySpan<System::Byte> bytes, Span<char> chars);

public override int GetChars(ReadOnlySpan<byte> bytes, Span<char> chars);

override this.GetChars : ReadOnlySpan<byte> * Span<char> -> int

Public Overrides Function GetChars (bytes As ReadOnlySpan(Of Byte), chars As Span(Of Char)) As Integer

Параметры

bytes

ReadOnlySpan<Byte>

Диапазон, содержащий байты для декодирования.

chars

Span<Char>

Диапазон, содержащий результирующий набор символов.

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

Int32

Фактическое число символов, записанных в chars.

Комментарии

Чтобы вычислить точный размер, необходимый GetChars для хранения результирующего символа, используйте GetCharCount. Чтобы вычислить максимальный размер, используйте GetMaxCharCount. Этот GetCharCount метод обычно позволяет выделять меньше памяти, а GetMaxCharCount метод обычно выполняется быстрее.

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, следует использовать Decoder метод или EncoderGetEncoder предоставленный GetDecoder методом соответственно.

ASCIIEncoding не предоставляет обнаружение ошибок. Любой байт больше шестнадцатеричного 0x7F декодируется как вопросительный знак Юникода ("?").

Предостережение

По соображениям безопасности следует использовать UTF8Encodingили UnicodeEncodingUTF32Encoding включить обнаружение ошибок.

GetChars(Byte*, Int32, Char*, Int32)

Исходный код:

ASCIIEncoding.cs

Важно!

Этот API несовместим с CLS.

Альтернативный вариант, совместимый с CLS

System.Text.ASCIIEncoding.GetChars(Byte[], Int32, Int32, Char[], Int32)

Декодирует последовательность байтов, начиная с указанного указателя байтов, в набор символов, хранящихся начиная с указанного указателя символов.

public:
 override int GetChars(System::Byte* bytes, int byteCount, char* chars, int charCount);

[System.CLSCompliant(false)]
public override int GetChars(byte* bytes, int byteCount, char* chars, int charCount);

[<System.CLSCompliant(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Параметры

bytes

Byte*

Указатель на первый байт для декодации.

byteCount

Int32

Количество байтов, которые необходимо декодировать.

chars

Char*

Указатель на расположение, с которого начинается запись результирующего набора символов.

charCount

Int32

Максимальное количество символов для записи.

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

Int32

Фактическое число символов, записанных в расположении, указанном chars.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

bytes равно null.

–или–

chars равно null.

ArgumentOutOfRangeException

byteCount или charCount меньше нуля.

ArgumentException

charCount меньше результирующего числа символов.

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

DecoderFallback задан как DecoderExceptionFallback.

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения полученных символов, приложение использует GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount. Этот GetCharCount метод обычно позволяет выделять меньше памяти, а GetMaxCharCount метод обычно выполняется быстрее.

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, приложение должно использовать Decoder или Encoder предоставленный GetDecoder методом GetEncoder соответственно.

ASCIIEncoding не предоставляет обнаружение ошибок. Любой байт больше шестнадцатеричного 0x7F декодируется как вопросительный знак Юникода ("?").

Предостережение

По соображениям безопасности приложение рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.

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

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)

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

Исходный код:

ASCIIEncoding.cs

Декодирует последовательность байтов из указанного массива байтов в указанный массив символов.

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);

public override int GetChars(byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);

override this.GetChars : byte[] * int * int * char[] * int -> int

Public Overrides Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Параметры

bytes

Byte[]

Массив байтов, содержащий последовательность байтов для декодирования.

byteIndex

Int32

Индекс первого байта для декодирования.

byteCount

Int32

Количество байтов, которые необходимо декодировать.

chars

Char[]

Массив символов, содержащий результирующий набор символов.

charIndex

Int32

Индекс, с которого начинается запись результирующего набора символов.

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

Int32

Фактическое число символов, записанных в chars.

Исключения

ArgumentNullException

bytes равно null.

–или–

chars равно null.

ArgumentOutOfRangeException

byteIndex или byteCountcharIndex меньше нуля.

–или–

byteIndex и byteCount не обозначайте допустимый диапазон в bytes.

–или–

charIndex не является допустимым индексом в chars.

ArgumentException

chars не имеет достаточной емкости от charIndex конца массива для размещения результирующего символа.

DecoderFallbackException

Произошла резервная ошибка (дополнительные сведения см. в разделе "Кодировка символов" в .NET)

-и-

DecoderFallback задан как DecoderExceptionFallback.

Примеры

В следующем примере показано, как декодировать диапазон элементов из массива байтов и хранить результат в наборе элементов в массиве символов Юникода.

using System;
using System.Text;

class ASCIIEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             65,  83,  67,  73,  73,  32,  69,
            110,  99, 111, 100, 105, 110, 103,
             32,  69, 120,  97, 109, 112, 108, 101
        };

        ASCIIEncoding ascii = new ASCIIEncoding();

        int charCount = ascii.GetCharCount(bytes, 6, 8);
        chars = new Char[charCount];
        int charsDecodedCount = ascii.GetChars(bytes, 6, 8, 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 ASCIIEncodingExample
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
             65,  83,  67,  73,  73,  32,  69, _
            110,  99, 111, 100, 105, 110, 103, _
             32,  69, 120,  97, 109, 112, 108, 101}

        Dim ascii As New ASCIIEncoding()

        Dim charCount As Integer = ascii.GetCharCount(bytes, 6, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = ascii.GetChars(bytes, 6, 8, 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

Комментарии

Чтобы вычислить точный размер массива, необходимый GetChars для хранения полученных символов, приложение использует GetCharCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxCharCount. Этот GetCharCount метод обычно позволяет выделять меньше памяти, а GetMaxCharCount метод обычно выполняется быстрее.

Данные для преобразования, такие как чтение данных из потока, могут быть доступны только в последовательных блоках. В этом случае или если объем данных настолько велик, что его необходимо разделить на меньшие блоки, приложение должно использовать Decoder или Encoder предоставленный GetDecoder методом GetEncoder соответственно.

ASCIIEncoding не предоставляет обнаружение ошибок. Любой байт больше шестнадцатеричного 0x7F декодируется как вопросительный знак Юникода ("?").

Предостережение

По соображениям безопасности приложение рекомендуется использовать UTF8EncodingUnicodeEncodingили UTF32Encoding включить обнаружение ошибок.

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

• GetCharCount(Byte[], Int32, Int32)
• GetMaxCharCount(Int32)
• GetDecoder()
• GetString(Byte[], Int32, Int32)