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 -> int64

Public Function GetChars (i As Integer, fieldoffset As Long, buffer As Char(), bufferoffset As Integer, length As Integer) As Long

从零开始的列序号。

行中作为读取操作起始位置的索引。

要读入字节流的缓冲区。

开始读取操作的 buffer 的索引。

要读取的字节数。

Int64

读取的实际字符数。

传递的索引位于 0 至 FieldCount 的范围之外。

GetChars 返回字段中的可用字符数。通常，这是字段的确切长度。但是，如果 GetChars 已使用从字段中获取字符，则返回的数字可能小于字段的确切长度。

如果传递的缓冲区为 null， GetChars 则返回字段的长度（以字符为单位）。

不执行任何转换，因此检索的数据必须已经是字符数组。