次の方法で共有

  • [アーティクル]

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

パラメーター

  • fieldOffset
    型: System. . :: . .Int64
    データの読み取りを開始する列内の 0 から始まるインデックスです。
  • buffer
    型: array<System. . :: . .Char> [] () [] []
    文字ストリームを読み取るバッファです。
  • bufferoffset
    型: System. . :: . .Int32
    データの書き込みを開始するバッファ内の 0 から始まるインデックスです。

戻り値

型: 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 は、列の長さを文字数で返します。

変換は行われないため、取得するデータは既に文字列配列になっている必要があります。