IDataRecord.GetChars メソッド

指定したバッファ オフセットを開始位置として、指定した列オフセットからバッファに、文字のストリームを配列として読み込みます。

Function GetChars( _
   ByVal i As Integer, _   ByVal fieldoffset As Long, _   ByVal buffer() As Char, _   ByVal bufferoffset As Integer, _   ByVal length As Integer _) As Long
[C#]
long GetChars(
   inti,longfieldoffset,char[] buffer,intbufferoffset,intlength);
[C++]
__int64 GetChars(
   inti,__int64fieldoffset,__wchar_tbuffer __gc[],intbufferoffset,intlength);
[JScript]
function GetChars(
   i : int,fieldoffset : long,buffer : Char[],bufferoffset : int,length : int) : long;

パラメータ

• i
  列の 0 から始まる序数。
• fieldoffset
  読み取り操作を開始する行内のインデックス。
• buffer
  バイト ストリームの読み込み先のバッファ。
• bufferoffset
  読み込みを開始する buffer のインデックス。
• length
  読み込むバイト数。

戻り値

実際に読み込んだ文字数。

例外

解説

GetChars がフィールド内の使用できる文字数を返します。ほとんどの場合、これは正確なフィールド長です。ただし、フィールドから文字を取得するために GetChars が既に使用されている場合、返される数値はそのフィールドの正確な長さよりも小さいことがあります。

null 参照 (Visual Basic では Nothing) のバッファを渡すと、 GetChars がフィールドの長さを文字数で返します。

変換は実行されません。したがって、取得されたデータは既に文字配列である必要があります。

必要条件

プラットフォーム: 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

参照

IDataRecord インターフェイス | IDataRecord メンバ | System.Data 名前空間