次の方法で共有


AdomdDataReader.GetChars Method

指定された列の値のストリームを示す 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
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
public final long GetChars (
    int i, 
    long fieldOffset, 
    char[] buffer, 
    int bufferoffset, 
    int length
)
public final function GetChars (
    i : int, 
    fieldOffset : long, 
    buffer : char[], 
    bufferoffset : int, 
    length : int
) : long

パラメータ

  • i
    取得する列の位置を示す 0 から始まる序数です。
  • fieldOffset
    データの読み取りを開始する列内の 0 から始まるインデックスです。
  • buffer
    文字ストリームを読み取るバッファです。
  • bufferoffset
    データの書き込みを開始するバッファ内の 0 から始まるインデックスです。
  • length
    列から読み取る文字数です。

戻り値

列から実際に読み取る文字数を表す Long です。

例外

例外の種類 条件
IndexOutOfRangeException

dataIndex の値が Int32.MaxValue より大きくなっています。

bufferIndex の値が 0 より小さいか、または lengthbuffer の長さの合計より大きくなっています。

この例外の詳細については、「IndexOutOfRangeException Class」を参照してください。

解説

GetChars メソッドは、フィールドで使用できる文字数を返します。多くの場合、これはフィールドの正確な長さになります。ただし、既に GetChars を使用してフィールドから文字を取得している場合、返される文字数はフィールドの正しい長さよりも少なくなる場合があります。

buffer パラメータに NULL 参照 (Microsoft Visual Basic では Nothing) を渡すと、GetBytes は、列の長さを文字数で返します。

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

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

AdomdDataReader Class
AdomdDataReader Members
Microsoft.AnalysisServices.AdomdServer Namespace