UTF7Encoding.GetMaxCharCount(Int32) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
计算通过解码指定字节数生成的最大字符数。
public:
override int GetMaxCharCount(int byteCount);public override int GetMaxCharCount(int byteCount);override this.GetMaxCharCount : int -> intPublic Overrides Function GetMaxCharCount (byteCount As Integer) As Integer参数
- byteCount
- Int32
要解码的字节数。
返回
通过解码指定字节数生成的最大字符数。
例外
发生回退（有关详细信息，请参阅 .NET 中的字符编码）
-以及-
示例
下面的代码示例演示如何使用 GetMaxCharCount 该方法返回通过解码指定字节数生成的最大字符数。
using System;
using System.Text;
class UTF7EncodingExample {
public static void Main() {
UTF7Encoding utf7 = new UTF7Encoding();
int byteCount = 8;
int maxCharCount = utf7.GetMaxCharCount(byteCount);
Console.WriteLine(
"Maximum of {0} characters needed to decode {1} bytes.",
maxCharCount,
byteCount
);
}
}
Imports System.Text
Class UTF7EncodingExample
Public Shared Sub Main()
Dim utf7 As New UTF7Encoding()
Dim byteCount As Integer = 8
Dim maxCharCount As Integer = utf7.GetMaxCharCount(byteCount)
Console.WriteLine( _
"Maximum of {0} characters needed to decode {1} bytes.", _
maxCharCount, _
byteCount _
)
End Sub
End Class
注解
若要计算存储生成的字符所需的 GetChars 确切数组大小，应用程序使用 GetCharCount。 若要计算最大数组大小，应用程序应使用 GetMaxCharCount。 此方法 GetCharCount 通常允许分配更少的内存，而 GetMaxCharCount 该方法通常执行速度更快。
GetMaxCharCount 是一个最差的数字，包括当前所选 DecoderFallback的最差情况。 如果使用可能较大的字符串选择回退， GetMaxCharCount 可以返回大值。
在大多数情况下，此方法返回小字符串的合理数字。 对于大型字符串，可能需要在极少数情况下使用非常大的缓冲区和捕获错误之间进行选择，即超出更合理的缓冲区。 你可能还想考虑使用GetCharCountDecoder.Convert或采用其他方法。
GetMaxCharCount 与 GetBytes. 如果应用程序需要使用类似的函数， GetBytes则应使用 GetMaxByteCount它。
注释
GetMaxCharCount(N) 不一定与 N* GetMaxCharCount(1)..
