UnicodeEncoding.GetMaxByteCount(Int32) 方法

定義

命名空間:

System.Text

組件:

System.Text.Encoding.Extensions.dll

Source:

UnicodeEncoding.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 小於零。

-或-

所產生的位元組數目大於可用整數傳回的數目上限。

EncoderFallbackException

發生後援 (如需詳細資訊，請參閱 .NET 中的字元編碼)

-和-

EncoderFallback 設定為 EncoderExceptionFallback。

範例

下列範例示範如何使用 GetMaxByteCount 方法來傳回編碼指定字元數目所需的位元組數目上限。

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

using System;
using System.Text;

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

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = uni.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 的不同方法。

GetMaxByteCount 與 沒有關聯 GetChars 。 如果您的應用程式需要與 搭配 GetChars 使用的類似函式，它應該使用 GetMaxCharCount 。

注意

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

另請參閱

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