UTF7Encoding.GetMaxByteCount(Int32) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
计算对指定数目的字符进行编码时产生的最大字节数。
public:
override int GetMaxByteCount(int charCount);public override int GetMaxByteCount (int charCount);override this.GetMaxByteCount : int -> intPublic Overrides Function GetMaxByteCount (charCount As Integer) As Integer参数
- charCount
- Int32
要编码的字符的数目。
返回
对指定数目的字符进行编码所产生的最大字节数。
例外
发生回退（有关详细信息，请参阅采用 .NET 的字符编码） －和－ 将 EncoderFallback 设置为 EncoderExceptionFallback。
示例
下面的代码示例演示如何使用 GetMaxByteCount 该方法返回编码指定字符数所需的最大字节数。
using namespace System;
using namespace System::Text;
int main()
{
UTF7Encoding^ utf7 = gcnew UTF7Encoding;
int charCount = 2;
int maxByteCount = utf7->GetMaxByteCount( charCount );
Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}
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 可以返回大值。
在大多数情况下，此方法返回小字符串的合理数字。 对于大型字符串，可能需要在极少数情况下选择使用非常大的缓冲区和捕获错误，即超出更合理的缓冲区。 你可能还需要考虑使用或的其他方法 GetByteCount Encoder.Convert 。 虽然 UTF-7 对 ASCII 数据进行编码非常高效，但每个字符一个字节，但对于其他数据来说，效率非常低。 如上所述， GetMaxByteCount 处理最坏的情况。 如果要编码的数据主要是 ASCII，尤其是 ASCII 字符聚集在一起时，UTF-7 比此方法返回的数字要高效得多。
GetMaxByteCount与之间没有关系 GetChars 。 如果应用程序需要使用类似的函数， GetChars则应使用它 GetMaxCharCount。
备注
GetMaxByteCount(N)不一定与相同 N* GetMaxByteCount(1) 。