GetChars メソッド
指定したフィールドの指定した位置を開始位置として、連続する文字をバッファにコピーします。
名前空間: System.Data.SqlServerCe
アセンブリ: System.Data.SqlServerCe (System.Data.SqlServerCe.dll)
構文
'宣言
Public Overrides Function GetChars ( _
ordinal As Integer, _
dataIndex As Long, _
buffer As Char(), _
bufferIndex As Integer, _
length As Integer _
) As Long
'使用
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(ordinal, _
dataIndex, buffer, bufferIndex, length)
public override long GetChars(
int ordinal,
long dataIndex,
char[] buffer,
int bufferIndex,
int length
)
public:
virtual long long GetChars(
int ordinal,
long long dataIndex,
array<wchar_t>^ buffer,
int bufferIndex,
int length
) override
abstract GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
override GetChars :
ordinal:int *
dataIndex:int64 *
buffer:char[] *
bufferIndex:int *
length:int -> int64
public override function GetChars(
ordinal : int,
dataIndex : long,
buffer : char[],
bufferIndex : int,
length : int
) : long
パラメーター
- ordinal
型: System. . :: . .Int32
データの取得元となるフィールドの序数位置。
- dataIndex
型: System. . :: . .Int64
コピーの開始位置となるフィールド内のオフセット (文字単位)。
- buffer
型: array<System. . :: . .Char> [] () [] []
データのコピー先のバッファ。
- bufferIndex
型: System. . :: . .Int32
コピーの開始位置となるバッファ内のオフセット。
- length
型: System. . :: . .Int32
コピーする最大バイト数。
戻り値
型: System. . :: . .Int64
実際にコピーされた文字数。
実装
IDataRecord. . :: . .GetChars(Int32, Int64, array<Char> [] () [] [], Int32, Int32)
説明
この関数では、実際にコピーされた文字数を返します。フィールドの末尾に達した場合は、この値が、要求した文字数より少なくなることがあります。
null バッファを渡すと、GetChars は文字数によるフィールド長を返します。
SequentialAccess のコマンド動作でコマンドが実行される場合、GetChars の呼び出しには、順次増加読み取りを指定する必要があります。それ以外の場合は、例外がスローされます。
指定した序数位置にフィールドが存在しない場合、例外がスローされます。