UnicodeEncoding.GetChars Метод

Определение

Пространство имен:
System.Text
Сборки:
netstandard.dll, System.Text.Encoding.Extensions.dll
Сборка:
System.Text.Encoding.Extensions.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Сборки:
mscorlib.dll, System.Text.Encoding.Extensions.dll

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

Перегрузки

Имя Описание
GetChars(Byte*, Int32, Char*, Int32)

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

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

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

Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs

Внимание

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

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

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)]
[System.Security.SecurityCritical]
public override int GetChars(byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetChars(byte* bytes, int byteCount, char* chars, int charCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(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
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetChars : nativeptr<byte> * int * nativeptr<char> * int -> int

Параметры

bytes
Byte*

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

byteCount
Int32

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

chars
Char*

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

charCount
Int32

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

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

Int32

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

Атрибуты
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Исключения

ArgumentNullException

bytes is null (Nothing).

–или–

chars is null (Nothing).

ArgumentOutOfRangeException

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

ArgumentException

Обнаружение ошибок включено и bytes содержит недопустимую последовательность байтов.

–или–

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

DecoderFallbackException

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

-и-

DecoderFallback задан как DecoderExceptionFallback.

Комментарии

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

При обнаружении ошибок недопустимая последовательность приводит к возникновению ArgumentExceptionэтого метода. Без обнаружения ошибок недопустимые последовательности игнорируются, и исключение не возникает.

Если диапазон байтов, который требуется декодировать, включает метку порядка байтов (BOM) и массив байтов был возвращен методом типа, отличного от BOM, символ U+FFFE включается в массив символов, возвращаемый этим методом. Его можно удалить, вызвав String.TrimStart метод.

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

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

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

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

Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.cs
Исходный код:
UnicodeEncoding.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 is null (Nothing).

–или–

chars is null (Nothing).

ArgumentOutOfRangeException

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

–или–

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

–или–

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

ArgumentException

Обнаружение ошибок включено и bytes содержит недопустимую последовательность байтов.

–или–

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

DecoderFallbackException

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

-и-

DecoderFallback задан как DecoderExceptionFallback.

Примеры

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

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        UnicodeEncoding Unicode = new UnicodeEncoding();

        int charCount = Unicode.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = Unicode.GetChars(bytes, 2, 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 UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
        
        Dim uni As New UnicodeEncoding()
        
        Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = uni.GetChars(bytes, 2, 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 метод обычно выполняется быстрее.

При обнаружении ошибок недопустимая последовательность приводит к возникновению ArgumentExceptionэтого метода. Без обнаружения ошибок недопустимые последовательности игнорируются, и исключение не возникает.

Если диапазон байтов, который требуется декодировать, включает метку порядка байтов (BOM) и массив байтов был возвращен методом типа, отличного от BOM, символ U+FFFE включается в массив символов, возвращаемый этим методом. Его можно удалить, вызвав String.TrimStart метод.

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

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

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