UTF8Encoding.GetCharCount Метод

Определение

Пространство имен:: 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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

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

GetCharCount(Byte[], Int32, Int32)

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

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

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

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

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

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

public:
 override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);

public override int GetCharCount(byte[] bytes, int index, int count);

override this.GetCharCount : byte[] * int * int -> int

Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer

Параметры

bytes: Byte[]

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

index: Int32

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

count: Int32

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

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

Int32

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

Исключения

ArgumentNullException

bytes равно null.

ArgumentOutOfRangeException

index или count меньше нуля.

–или–

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

–или–

Результирующее число байтов больше максимального числа, которое может быть возвращено в виде целого числа.

ArgumentException

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

DecoderFallbackException

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

-и-

DecoderFallback задан как DecoderExceptionFallback.

Примеры

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

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        Byte[] bytes = new Byte[] {
             85,  84,  70,  56,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF8Encoding utf8 = new UTF8Encoding();
        int charCount = utf8.GetCharCount(bytes, 2, 8);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte = { _
            85,  84,  70,  56,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf8 As New UTF8Encoding()
        Dim charCount As Integer = utf8.GetCharCount(bytes, 2, 8)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

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

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

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

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

GetCharCount(Byte*, Int32)

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

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

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

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

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

Внимание

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

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

public:
 override int GetCharCount(System::Byte* bytes, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);

[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);

[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int

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

[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int

Параметры

bytes: Byte*

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

count: Int32

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

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

Int32

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

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

Исключения

ArgumentNullException

bytes равно null.

ArgumentOutOfRangeException

count меньше нуля.

–или–

Результирующее число байтов больше максимального числа, которое может быть возвращено в виде целого числа.

ArgumentException

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

DecoderFallbackException

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

-и-

DecoderFallback задан как DecoderExceptionFallback.

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

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

GetCharCount(ReadOnlySpan<Byte>)

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

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

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

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

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

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

public:
 override int GetCharCount(ReadOnlySpan<System::Byte> bytes);

public override int GetCharCount(ReadOnlySpan<byte> bytes);

override this.GetCharCount : ReadOnlySpan<byte> -> int

Public Overrides Function GetCharCount (bytes As ReadOnlySpan(Of Byte)) As Integer

Параметры

bytes: ReadOnlySpan<Byte>

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

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

Int32

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

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

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

Обратная связь

Были ли сведения на этой странице полезными?

UTF8Encoding.GetCharCount Метод

Определение

Перегрузки

GetCharCount(Byte[], Int32, Int32)

Параметры

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

Исключения

Примеры

Комментарии

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

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

GetCharCount(Byte*, Int32)

Параметры

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

Исключения

Комментарии

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

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

GetCharCount(ReadOnlySpan<Byte>)

Параметры

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

Комментарии

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