UnicodeEncoding.GetMaxByteCount(Int32) 方法

定义

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

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

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 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。 若要计算最大数组大小，应用程序应使用 GetMaxByteCount。 该方法 GetByteCount 通常分配较少的内存，而 GetMaxByteCount 该方法通常执行速度更快。

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

在大多数情况下，此方法检索小字符串的合理数字。 对于大型字符串，可能需要在极少数情况下使用非常大的缓冲区和捕获错误之间进行选择，即超出更合理的缓冲区。 你可能还想考虑使用GetByteCountEncoder.Convert或采用其他方法。

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

注释

GetMaxByteCount(N) 不一定与 N* GetMaxByteCount(1)..

适用于

另请参阅