UTF7Encoding.GetMaxByteCount(Int32) 方法

定义

命名空间:

System.Text

程序集:

System.Text.Encoding.Extensions.dll

Source:

UTF7Encoding.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 小于零。

- 或 -

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

EncoderFallbackException

发生回退（有关详细信息，请参阅采用 .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 可以返回较大的值。

在大多数情况下，此方法为小字符串返回合理的数字。 对于大型字符串，可能需要选择使用非常大的缓冲区和捕获错误（在极少数情况下超出更合理的缓冲区）。 你可能还需要考虑使用或的其他方法 GetByteCountEncoder.Convert 。 虽然 UTF-7 在编码 ASCII 数据（每个字符一个字节）方面非常高效，但对于其他数据而言，它效率极低。 如上所述， GetMaxByteCount 处理最坏的情况。 如果要编码的数据主要是 ASCII，尤其是当 ASCII 字符聚集在一起时，UTF-7 的效率明显高于此方法建议返回的数字。

GetMaxByteCount与之间没有关系 GetChars 。 如果应用程序需要与 一起使用 GetChars的类似函数，则应使用 GetMaxCharCount。

注意

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

另请参阅

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