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

Int64long 值，會位移至包含在 SqlChars 執行個體中的值。

要複製的目標字元陣列緩衝區。

緩衝區中要開始進行資料複製的 Int32 整數位移。

Int32 整數值，表示要複製的字元數目。

Int64

Int64long 值，表示複製的位元組數目。

如果嘗試讀取超過 MaxLength，則會擲回例外狀況。

如果 count 指定要複製的字元數超過從 offsetInBuffer 到值結尾可用的字元數，則只會複製可用的字元。

如果目的地緩衝區是 Null 參考，則會擲回例外狀況。

如果目的地緩衝區無法接收所要求的字元數，就會擲回例外狀況。