AdomdDataReader.GetChars 方法

返回包含来自指定列的值的流的 Char 对象的数组。

命名空间:  Microsoft.AnalysisServices.AdomdServer
程序集:  msmgdsrv(在 msmgdsrv.dll 中)

语法

声明
Public Function GetChars ( _
    i As Integer, _
    fieldOffset As Long, _
    buffer As Char(), _
    bufferoffset As Integer, _
    length As Integer _
) As Long
用法
Dim instance As AdomdDataReader 
Dim i As Integer 
Dim fieldOffset As Long 
Dim buffer As Char()
Dim bufferoffset As Integer 
Dim length As Integer 
Dim returnValue As Long 

returnValue = instance.GetChars(i, fieldOffset, _
    buffer, bufferoffset, length)
public long GetChars(
    int i,
    long fieldOffset,
    char[] buffer,
    int bufferoffset,
    int length
)
public:
virtual long long GetChars(
    int i, 
    long long fieldOffset, 
    array<wchar_t>^ buffer, 
    int bufferoffset, 
    int length
) sealed
abstract GetChars : 
        i:int * 
        fieldOffset:int64 * 
        buffer:char[] * 
        bufferoffset:int * 
        length:int -> int64  
override GetChars : 
        i:int * 
        fieldOffset:int64 * 
        buffer:char[] * 
        bufferoffset:int * 
        length:int -> int64
public final function GetChars(
    i : int, 
    fieldOffset : long, 
    buffer : char[], 
    bufferoffset : int, 
    length : int
) : long

参数

  • i
    类型:Int32
    要检索的列的从零开始的序号位置。
  • fieldOffset
    类型:Int64
    列中要自其开始读取数据的从零开始的索引。
  • buffer
    类型:array<Char[]
    要将字符流读入的缓冲区。
  • bufferoffset
    类型:Int32
    缓冲区中要自其开始写入数据的从零开始的索引。
  • length
    类型:Int32
    要从该列读取的字符数。

返回值

类型:Int64
一个长整型值,该值包含从该列中实际读取的字符数。

实现

IDataRecordGetChars(Int32, Int64, Char, Int32, Int32)

异常

异常 条件
[IndexOutOfRangeException]

dataIndex 的值大于 Int32.MaxValue。

bufferIndex 的值小于 0 或大于总 length 和 buffer 的长度。

有关此异常的详细信息,请参阅IndexOutOfRangeException Class

注释

GetChars 方法返回字段中的可用字符数。 在大多数情况下,这是字段的确切长度。 但是,如果 GetChars 已用于从字段获取字符,返回的数字可能小于字段的真实长度。

如果您在 buffer 参数中传递 null 引用(Microsoft Visual Basic 中为 Nothing),GetBytes 将返回列的长度(字符)。

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

请参阅

参考

AdomdDataReader 类

Microsoft.AnalysisServices.AdomdServer 命名空间