次の方法で共有


OracleDataReader.GetChars メソッド

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

Public Overridable Function GetChars( _
   ByVal i As Integer, _   ByVal fieldOffset As Long, _   ByVal buffer2() As Char, _   ByVal bufferoffset As Integer, _   ByVal length As Integer _) As Long Implements IDataRecord.GetChars
[C#]
public virtual long GetChars(inti,longfieldOffset,char[] buffer2,intbufferoffset,intlength);
[C++]
public: virtual __int64 GetChars(inti,__int64fieldOffset,__wchar_tbuffer2 __gc[],intbufferoffset,intlength);
[JScript]
public function GetChars(
   i : int,fieldOffset : long,buffer2 : Char[],bufferoffset : int,length : int) : long;

パラメータ

  • i
    列の 0 から始まる序数。
  • fieldOffset
    読み込みを開始する行内のインデックス。
  • buffer2
    データのコピー先のバッファ。
  • bufferoffset
    buffer が書き込み操作を開始するインデックス。
  • length
    読み込む文字数。

戻り値

実際に読み込まれた文字数。

実装

IDataRecord.GetChars

解説

GetChars は、フィールド内で利用可能な文字数を返します。ほとんどの場合、これは正確なフィールド長です。ただし、既に GetChars を使用してフィールドから文字を取得している場合は、返される文字数が、フィールドの実際の長さよりも小さくなることがあります。これは、 OracleDataReader が大きいデータ構造体をバッファに読み込んでいるときなどに起こります。詳細については、「 CommandBehavior 」の SequentialAccess 設定を参照してください。

null 値のバッファを渡すと、 GetChars は、文字列単位のフィールド長を返します。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

OracleDataReader クラス | OracleDataReader メンバ | System.Data.OracleClient 名前空間