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，则会引发异常。

如果 count 指定要复制的字符数多于从 offsetInBuffer 值到末尾的可用字符数，则仅复制可用字符。

如果目标缓冲区为 null 引用，则会引发异常。

如果目标缓冲区无法收到请求的任意数量的字符，则会引发异常。