UTF8Encoding.GetMaxByteCount(Int32) 方法

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

参数

返回

通过编码指定字符数生成的最大字节数。

例外

示例

下面的示例使用 GetMaxByteCount 该方法返回对指定数量的字符进行编码所需的最大字节数。

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int charCount = 2;
        int maxByteCount = utf8.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

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

注解

若要计算存储生成的字节所需的 GetBytes 确切数组大小，请调用 GetByteCount 该方法。 若要计算最大数组大小，请调用 GetMaxByteCount 该方法。 该方法 GetByteCount 通常分配较少的内存，而 GetMaxByteCount 该方法通常执行速度更快。

GetMaxByteCount 是一个最差的数字，包括当前所选 EncoderFallback的最差情况。 如果使用可能较大的字符串选择回退， GetMaxByteCount 可以返回大值。

在大多数情况下，此方法返回小字符串的合理数字。 对于大型字符串，可能需要在极少数情况下使用非常大的缓冲区和捕获错误之间进行选择，即超出更合理的缓冲区。 你可能还想考虑使用GetByteCountEncoder.Convert或采用其他方法。 例如，英语和许多其他语言的文本通常只需要一个 UTF-8 字节来表示字符，但返回 GetMaxByteCount 的数字必须允许转换字符串的可能性将完全包含每个字符需要四个字节。

GetMaxByteCount 与 GetChars. 如果应用程序需要使用类似的函数， GetChars则应使用 GetMaxCharCount它。

另请参阅

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetEncoder()