通过

UTF8Encoding.GetMaxByteCount(Int32) 方法

  • 参考

定义

命名空间:
System.Text
程序集:
System.Text.Encoding.Extensions.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
UTF8Encoding.cs
Source:
UTF8Encoding.cs
Source:
UTF8Encoding.cs

计算对指定数目的字符进行编码时产生的最大字节数。

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

要编码的字符的数目。

返回

Int32

对指定数目的字符进行编码所产生的最大字节数。

例外

ArgumentOutOfRangeException

charCount 小于零。

或

得到的字节数大于可作为整数返回的最大数量。

EncoderFallbackException

发生回退（有关详细信息，请参阅采用 .NET 的字符编码）

－和－

将 EncoderFallback 设置为 EncoderExceptionFallback。

示例

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

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

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。

注意

GetMaxByteCount(N)不一定与相同 N* GetMaxByteCount(1) 。

适用于

另请参阅