UnicodeEncoding.GetCharCount Метод

Определение

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

System.Text

Сборка:

System.Text.Encoding.Extensions.dll

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

Перегрузки

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

GetCharCount(Byte*, Int32)

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

UnicodeEncoding.cs

Важно!

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

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

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

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

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

Параметры

bytes

Byte*

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

count

Int32

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

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

Int32

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

bytes имеет значение null (Nothing).

ArgumentOutOfRangeException

Значение параметра count меньше нуля.

-или-

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

ArgumentException

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

DecoderFallbackException

Произошел откат (см. сведения о кодировке символов в .NET)

- и -

Параметру DecoderFallback задается значение DecoderExceptionFallback.

Комментарии

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

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

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

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()

GetCharCount(Byte[], Int32, Int32)

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

UnicodeEncoding.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 (Nothing).

ArgumentOutOfRangeException

Значение параметра index или count меньше нуля.

-или-

Параметрыindex и count не указывают допустимый диапазон в bytes.

-или-

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

ArgumentException

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

DecoderFallbackException

Произошел откат (см. сведения о кодировке символов в .NET)

- и -

Параметру DecoderFallback задается значение DecoderExceptionFallback.

Примеры

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

using namespace System;
using namespace System::Text;
int main()
{
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = Unicode->GetCharCount( bytes, 2, 8 );
   Console::WriteLine( "{0} characters needed to decode bytes.", charCount );
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        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);
        Console.WriteLine(
            "{0} characters needed to decode bytes.", charCount
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        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)
        Console.WriteLine("{0} characters needed to decode bytes.", charCount)
    End Sub
End Class

Комментарии

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

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

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

• GetChars
• GetMaxCharCount(Int32)
• GetDecoder()