SqlDataRecord.GetChars(Int32, Int64, Char[], Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
获取序号指定的列的值，其形式为 Char 对象数组。
public:
virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long参数
- ordinal
- Int32
从零开始的列序号。
- fieldOffset
- Int64
开始检索字符的字段值偏移量。
- buffer
- Char[]
要将字符复制到其中的目标缓冲区。
- bufferOffset
- Int32
开始复制字符的缓冲区偏移量。
- length
- Int32
要复制到缓冲区的字符数。
返回
复制的字符数。
实现
例外
ordinal 小于 0 或大于列数（即 FieldCount）。
ordinal 指定的列为 null。
类型不匹配。
注解
此方法使你能够在单个调用或区块中获取字符值。 对于较大的值或未知大小的值，获取区块中的值很有用。
若要获取多个区块中的值，请分配区块大小的 char 数组，并在每次调用 GetChars 中重复调整 fieldOffset 参数。