UnicodeEncoding.GetMaxByteCount(Int32) Метод

Определение

Вычисляет максимальное количество байтов, полученных при кодировании заданного числа символов.Calculates the maximum number of bytes produced by encoding the specified number of characters.

public:
 override int GetMaxByteCount(int charCount);
public override int GetMaxByteCount (int charCount);
override this.GetMaxByteCount : int -> int
Public Overrides Function GetMaxByteCount (charCount As Integer) As Integer

Параметры

charCount
Int32

Число кодируемых символов.The number of characters to encode.

Возвраты

Максимальное количество байтов, полученных при кодировании заданного количества символов.The maximum number of bytes produced by encoding the specified number of characters.

Исключения

Значение параметра charCount меньше нуля.charCount is less than zero.

-или--or- Результирующее число байтов больше максимального количества, которое можно вернуть как целочисленное значение.The resulting number of bytes is greater than the maximum number that can be returned as an integer.

Произошла отработка отказа (см. полное объяснение в статье Кодировка символов в .NET Framework)A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation) - и --and- Параметру EncoderFallback задается значение EncoderExceptionFallback.EncoderFallback is set to EncoderExceptionFallback.

Примеры

В следующем примере показано, как использовать GetMaxByteCount метод для возврата максимального числа байтов, необходимого для кодирования указанного числа символов.The following example demonstrates how to use the GetMaxByteCount method to return the maximum number of bytes required to encode a specified number of characters.

using namespace System;
using namespace System::Text;
int main()
{
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int charCount = 2;
   int maxByteCount = Unicode->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        UnicodeEncoding Unicode = new UnicodeEncoding();
        int charCount = 2;
        int maxByteCount = Unicode.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}
Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = uni.GetMaxByteCount(charCount)
        Console.WriteLine("Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount)
    End Sub
End Class

Комментарии

Чтобы вычислить точный размер массива, GetBytes необходимый для хранения результирующих байтов, приложение использует GetByteCount.To calculate the exact array size required by GetBytes to store the resulting bytes, the application uses GetByteCount. Чтобы вычислить максимальный размер массива, приложение должно использовать GetMaxByteCount.To calculate the maximum array size, the application should use GetMaxByteCount. Метод обычно выделяет меньше памяти, в GetMaxByteCount то время как метод обычно выполняется быстрее. GetByteCountThe GetByteCount method generally allocates less memory, while the GetMaxByteCount method generally executes faster.

GetMaxByteCountИзвлекает значение наихудшего регистра, включая наихудший случай для выбранного EncoderFallbackв данный момент.GetMaxByteCount retrieves a worst-case number, including the worst case for the currently selected EncoderFallback. Если резервный вариант выбирается с потенциально большой строкой GetMaxByteCount , может возвращать большие значения.If a fallback is chosen with a potentially large string, GetMaxByteCount can return large values.

В большинстве случаев этот метод извлекает разумные числа для небольших строк.In most cases, this method retrieves reasonable numbers for small strings. В случае больших строк может потребоваться выбрать использование очень больших буферов и перехват ошибок в редких случаях, когда превышено разумный размер буфера.For large strings, you might have to choose between using very large buffers and catching errors in the rare case that a more reasonable buffer is exceeded. Также можно рассмотреть другой подход с помощью GetByteCount или. Encoder.ConvertYou might also want to consider a different approach using GetByteCount or Encoder.Convert.

GetMaxByteCountне имеет отношения к GetChars.GetMaxByteCount has no relation to GetChars. Если приложению требуется аналогичная функция для использования с GetChars, следует использовать. GetMaxCharCountIf your application needs a similar function to use with GetChars, it should use GetMaxCharCount.

Примечание

GetMaxByteCount(N)не обязательно то же значение, что N* GetMaxByteCount(1)и.GetMaxByteCount(N) is not necessarily the same value as N* GetMaxByteCount(1).

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

Дополнительно