UTF7Encoding.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 UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        int charCount = 2;
        int maxByteCount = utf7.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = utf7.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-7 对 ASCII 数据进行编码非常高效，但对于其他数据来说，它非常低效。 如上所述， GetMaxByteCount 处理最坏的情况。 如果要编码的数据主要是 ASCII，尤其是 ASCII 字符聚集在一起时，UTF-7 比此方法返回的数字要高效得多。

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

另请参阅

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