UTF7Encoding.GetMaxByteCount(Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した文字数をエンコードすることによって生成される最大バイト数を計算します。
public:
override int GetMaxByteCount(int charCount);public override int GetMaxByteCount (int charCount);override this.GetMaxByteCount : int -> intPublic 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 データ (1 文字あたり 1 バイト) のエンコードに非常に効率的ですが、他のデータでは非常に非効率的です。 前述のように、 GetMaxByteCount 最悪のケースを扱います。 エンコードするデータが大部分が ASCII である場合、特に ASCII 文字が一緒にクラスター化されている場合、UTF-7 は、このメソッドによって返される数よりも大幅に効率的です。
GetMaxByteCountには関係がありません GetChars 。 アプリケーションで使用 GetCharsする同様の関数が必要な場合は、使用する必要があります GetMaxCharCount。
注意
GetMaxByteCount(N)はと同じ値であるとは限りません N* GetMaxByteCount(1) 。