派生クラスでオーバーライドされた場合は、指定した文字配列内の文字の範囲をエンコードするために必要なバイト数を返します。
Overloads Public MustOverride Function GetByteCount( _
ByVal chars() As Char, _ ByVal index As Integer, _ ByVal count As Integer _) As Integer
[C#]
public abstract int GetByteCount(char[] chars,intindex,intcount);
[C++]
public: virtual int GetByteCount(__wchar_tchars __gc[],intindex,intcount) = 0;
[JScript]
public abstract function GetByteCount(
chars : Char[],index : int,count : int) : int;
パラメータ
- chars
エンコードする文字配列。 - index
エンコードする文字配列の開始インデックス。 - count
エンコードする文字数。
戻り値
指定した範囲の文字をエンコードするために必要なバイト数。
例外
| 例外の種類 | 条件 |
|---|---|
| ArgumentNullException | chars が null 参照 (Visual Basic では Nothing) です。 |
| ArgumentOutOfRangeException | index または count が 0 未満です。
または index および count が文字配列内の有効範囲を示していません。 |
解説
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 オーバーロードの一覧