UTF8Encoding.GetMaxCharCount(Int32) Метод

public:
 override int GetMaxCharCount(int byteCount);

public override int GetMaxCharCount(int byteCount);

override this.GetMaxCharCount : int -> int

Public Overrides Function GetMaxCharCount (byteCount As Integer) As Integer

Параметры

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

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

Исключения

Примеры

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

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int byteCount = 8;
        int maxCharCount = utf8.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = utf8.GetMaxCharCount(byteCount)
        Console.WriteLine( _
            "Maximum of {0} characters needed to decode {1} bytes.", _
            maxCharCount, _
            byteCount _
        )
    End Sub
End Class

Комментарии

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

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

В большинстве случаев этот метод возвращает разумные числа для небольших строк. Для больших строк может потребоваться выбрать использование очень больших буферов и перехват ошибок в редких случаях превышения более разумного буфера. Вы также можете рассмотреть другой подход с помощью GetCharCount или Encoder.Convert.

GetMaxCharCount не имеет отношения к GetBytes. Если приложению требуется аналогичная функция для использования GetBytes, она должна использоваться GetMaxByteCount.

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

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetString(Byte[], Int32, Int32)
• GetCharCount(Byte[], Int32, Int32)
• GetDecoder()