IDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたバッファー オフセットから始まる、指定した列オフセットからバッファーに文字のストリームを配列として読み取ります。
public:
long GetChars(int i, long fieldoffset, cli::array <char> ^ buffer, int bufferoffset, int length);public long GetChars(int i, long fieldoffset, char[]? buffer, int bufferoffset, int length);public long GetChars(int i, long fieldoffset, char[] buffer, int bufferoffset, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Longパラメーター
- i
- Int32
0 から始まる列の序数。
- fieldoffset
- Int64
読み取り操作を開始する行内のインデックス。
- buffer
- Char[]
バイトストリームを読み取るバッファー。
- bufferoffset
- Int32
読み取り操作を開始する buffer のインデックス。
- length
- Int32
読み取るバイト数。
返品
読み取られた実際の文字数。
例外
渡されたインデックスが 0 から FieldCount の範囲外でした。
注釈
GetChars は、フィールドで使用可能な文字数を返します。 多くの場合、これはフィールドの正確な長さです。 ただし、 GetChars がフィールドから文字を取得するために既に使用されている場合は、返される数がフィールドの正確な長さよりも小さい場合があります。
nullされているバッファーを渡すと、GetCharsはフィールドの長さを文字で返します。
変換は実行されません。したがって、取得されるデータは既に文字配列である必要があります。
