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 将返回列的长度（字符）。
不执行任何转换；因此检索的数据必须已经是字符数组。