ASCIIEncoding.GetMaxCharCount(Int32) Метод

Ссылка

Определение

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

Сборки:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Сборка:: System.Text.Encoding.Extensions.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

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

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

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 namespace System;
using namespace System::Text;
int main()
{
   ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
   int byteCount = 8;
   int maxCharCount = ascii->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

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.

Примечание

GetMaxCharCount(N)не обязательно то же значение, что и N* GetMaxCharCount(1) .

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