SqlCeResultSet.GetChars 方法

从指定字段中的指定位置开始,将一定长度的字符复制到缓冲区中。

命名空间:  System.Data.SqlServerCe
程序集:  System.Data.SqlServerCe(在 System.Data.SqlServerCe.dll 中)

语法

声明
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
用法
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(ordinal, _
    dataIndex, buffer, bufferIndex, length)
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetChars(
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

参数

  • ordinal
    类型:System.Int32
    字段中将从其检索数据的序号位置。
  • dataIndex
    类型:System.Int64
    字段中将从其开始复制的偏移量(以字符为单位)。
  • buffer
    类型:array<System.Char[]
    作为数据复制目标的缓冲区。
  • bufferIndex
    类型:System.Int32
    缓冲区中将从其开始复制的偏移量。
  • length
    类型:System.Int32
    要复制的最大字节数。

返回值

类型:System.Int64
复制的实际字符数。

实现

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

注释

此函数返回复制的实际字符数;如果已到达字段的结尾,则实际字符数可能小于请求的长度。

如果传入一个空缓冲区,则 GetChars 以字符为单位返回字段的长度。

如果使用 SequentialAccess 命令行为执行此命令,则调用 GetChars 时必须指定按顺序递增读取,否则将会引发异常。

如果在指定的序号位置不存在任何字段,则会引发异常。

请参阅

参考

SqlCeResultSet 类

System.Data.SqlServerCe 命名空间