Encoding.GetBytes メソッド (Char[], Int32, Int32, Byte , Int32)

派生クラスでオーバーライドされた場合は、ある範囲の文字を文字配列からバイト配列にエンコードします。

Overloads Public MustOverride Function GetBytes( _
   ByVal chars() As Char, _   ByVal charIndex As Integer, _   ByVal charCount As Integer, _   ByVal bytes() As Byte, _   ByVal byteIndex As Integer _) As Integer
[C#]
public abstract int GetBytes(char[] chars,intcharIndex,intcharCount,byte[] bytes,intbyteIndex);
[C++]
public: virtual int GetBytes(__wchar_tchars __gc[],intcharIndex,intcharCount,unsigned charbytes __gc[],intbyteIndex) = 0;
[JScript]
public abstract function GetBytes(
   chars : Char[],charIndex : int,charCount : int,bytes : Byte[],byteIndex : int) : int;

パラメータ

• chars
  エンコードする文字配列。
• charIndex
  エンコードする文字配列の開始インデックス。
• charCount
  エンコードする文字数。
• bytes
  エンコードされた結果が格納されているバイト配列。
• byteIndex
  バイト配列内の、エンコードされた結果の開始インデックス。

戻り値

bytes 配列に格納されているバイト数。

例外

例外の種類	条件
ArgumentException	bytes には、エンコードされた文字を格納するために必要な領域がありません。
ArgumentNullException	chars または bytes が null 参照 (Visual Basic では Nothing) です。
ArgumentOutOfRangeException	charIndex, charCount または byteIndex が 0 未満です。 または charIndex + charCount が chars の長さを超えています。

解説

文字配列内の文字の範囲を、バイト配列内のバイトの範囲にエンコードします。バイト配列が文字の完全なエンコーディングを保持できるほど大きくない場合は、例外が発生します。

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.GetBytes オーバーロードの一覧 | GetByteCount | GetMaxByteCount | GetDecoder | GetEncoder