UTF7Encoding.GetMaxByteCount(Int32) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
計算將指定數目的字元編碼所產生的最大位元組數目。
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
要編碼的字元數。
傳回
編碼指定字元數所產生的最大位元組數。
例外狀況
發生後援 (如需詳細資訊,請參閱 .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)
。