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
型: System.Int32
取得する列の位置を示す 0 から始まる序数です。
- fieldOffset
型: System.Int64
データの読み取りを開始する列内の 0 から始まるインデックスです。
- buffer
型: array<System.Char[]
文字ストリームを読み取るバッファーです。
- bufferoffset
型: System.Int32
データの書き込みを開始するバッファー内の 0 から始まるインデックスです。
- length
型: System.Int32
列から読み取る文字数です。
戻り値
型: System.Int64
列から実際に読み取る文字数を表す Long です。
実装
IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)
例外
| 例外 | 条件 |
|---|---|
| [IndexOutOfRangeException] | dataIndex の値が Int32.MaxValue より大きくなっています。 bufferIndex の値が 0 より小さいか、または length と buffer の長さの合計より大きくなっています。 この例外の詳細については、「IndexOutOfRangeException Class」を参照してください。 |
説明
GetChars メソッドは、フィールドで使用できる文字数を返します。 多くの場合、これはフィールドの正確な長さになります。 ただし、既に GetChars を使用してフィールドから文字を取得している場合、返される文字数はフィールドの正しい長さよりも少なくなる場合があります。
buffer パラメーターに NULL 参照 (Microsoft Visual Basic では Nothing) を渡すと、GetBytes は、列の長さを文字数で返します。
変換は行われないため、取得するデータは既に文字列配列になっている必要があります。