SqlChars.Read(Int64, Char[], Int32, Int32) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

この SqlChars のインスタンスから、引数に指定されたバッファーに文字をコピーし、コピーされた文字数を返します。

public:
 long Read(long offset, cli::array <char> ^ buffer, int offsetInBuffer, int count);

public long Read (long offset, char[] buffer, int offsetInBuffer, int count);

member this.Read : int64 * char[] * int * int -> int64

Public Function Read (offset As Long, buffer As Char(), offsetInBuffer As Integer, count As Integer) As Long

SqlChars インスタンス内の値のオフセット位置 (Int64long 値)。

コピー対象の文字配列バッファー。

バッファー内のコピー開始位置を示すオフセット値 (Int32 整数)。

コピーする文字数を表す Int32 型の整数値。

Int64

コピーされたバイト数を表す Int64long 値。

を超えて MaxLength読み取ろうとすると、例外がスローされます。

で使用できるoffsetInBuffer文字よりも多くの文字を値の末尾にコピーするように指定した場合countは、使用可能な文字のみがコピーされます。

ターゲットバッファーが null 参照である場合は、例外がスローされます。

宛先バッファーが要求された数の文字を受信できない場合は、例外がスローされます。