指定した文字配列をエンコードするために必要なバイト数を計算します。
Overloads Public Overridable Function GetByteCount( _
ByVal chars() As Char _) As Integer
[C#]
public virtual int GetByteCount(char[] chars);
[C++]
public: virtual int GetByteCount(__wchar_tchars __gc[]);
[JScript]
public function GetByteCount(
chars : Char[]) : int;
パラメータ
- chars
エンコードする文字配列。
戻り値
chars をエンコードするために必要なバイト数。
例外
例外の種類 | 条件 |
---|---|
ArgumentNullException | chars が null 参照 (Visual Basic では Nothing) です。 |
解説
GetByteCount を使用すると、指定した文字配列のエンコードによって生成される正確なバイト数を確認できます。その変換に対して適切なサイズに設定されたバッファは、その後、割り当てることができます。
または、 GetMaxByteCount を使用すると、指定した文字数の変換によって生成される最大バイト数を確認できます。そのサイズのバッファは、その後、複数の変換で再利用できます。
通常、 GetByteCount メソッドの方が使用メモリが少なく、 GetMaxByteCount メソッドの方が高速に実行されます。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET, Common Language Infrastructure (CLI) Standard
参照
Encoding クラス | Encoding メンバ | System.Text 名前空間 | Encoding.GetByteCount オーバーロードの一覧