ASCIIEncoding.GetMaxCharCount(Int32) Метод

Определение

Пространство имен:
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
Исходный код:
ASCIIEncoding.cs
Исходный код:
ASCIIEncoding.cs
Исходный код:
ASCIIEncoding.cs
Исходный код:
ASCIIEncoding.cs
Исходный код:
ASCIIEncoding.cs

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

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

Параметры

byteCount
Int32

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

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

Int32

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

Исключения

ArgumentOutOfRangeException

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

–или–

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

Примеры

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

using System;
using System.Text;

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

Imports System.Text

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

Комментарии

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

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

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

Note

GetMaxCharCount(N) не обязательно совпадает со значением N* GetMaxCharCount(1).

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

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