UTF8Encoding.GetMaxByteCount 方法

计算对指定数目的字符进行编码时产生的最大字节数。

**命名空间:**System.Text
**程序集:**mscorlib（在 mscorlib.dll 中）

语法

声明
Public Overrides Function GetMaxByteCount ( _
    charCount As Integer _
) As Integer
用法
Dim instance As UTF8Encoding
Dim charCount As Integer
Dim returnValue As Integer

returnValue = instance.GetMaxByteCount(charCount)

public override int GetMaxByteCount (
    int charCount
)

public:
virtual int GetMaxByteCount (
    int charCount
) override

public int GetMaxByteCount (
    int charCount
)

public override function GetMaxByteCount (
    charCount : int
) : int

参数

• charCount
  要编码的字符的数目。

返回值

对指定数目的字符进行编码所产生的最大字节数。

异常

异常类型	条件
ArgumentOutOfRangeException	charCount 小于零。 - 或 - 产生的字节数大于允许作为 int 返回的最大字节数。

备注

若要计算 GetBytes 存储结果字节所需的精确数组大小，请使用 GetByteCount。若要计算最大数组大小，请使用 GetMaxByteCount。GetByteCount 方法通常使您能够分配较少的内存，而 GetMaxByteCount 方法通常执行得更快。

示例

下面的示例演示了如何使用 GetMaxByteCount 方法返回对指定数目的字符进行编码所需要的最大字节数。

Imports System
Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = utf8.GetMaxByteCount(charCount)
        Console.WriteLine( _
            "Maximum of {0} bytes needed to encode {1} characters.", _
            maxByteCount, _
            charCount _
        )
    End Sub 'Main
End Class 'UTF8EncodingExample

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int charCount = 2;
        int maxByteCount = utf8.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

using namespace System;
using namespace System::Text;
int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int charCount = 2;
   int maxByteCount = utf8->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

import System.*;
import System.Text.*;

class UTF8EncodingExample
{
    public static void main(String[] args)
    {
        UTF8Encoding utf8 = new UTF8Encoding();
        int charCount = 2;
        int maxByteCount = utf8.GetMaxByteCount(charCount);

        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.", 
            String.valueOf(maxByteCount), String.valueOf(charCount));
    } //main
} //UTF8EncodingExample

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

.NET Compact Framework

受以下版本支持：2.0、1.0

请参见

参考

UTF8Encoding 类
UTF8Encoding 成员
System.Text 命名空间
GetBytes
GetByteCount
GetEncoder