次の方法で共有


AdomdDataReader.GetChars Method

指定された列の値のストリームを示す Char オブジェクトの配列を返します。

名前空間: Microsoft.AnalysisServices.AdomdClient
アセンブリ: Microsoft.AnalysisServices.AdomdClient (microsoft.analysisservices.adomdclient.dll 内)

構文

'宣言
Public Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
public long GetChars (
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars (
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) sealed
public final long GetChars (
    int ordinal, 
    long dataIndex, 
    char[] buffer, 
    int bufferIndex, 
    int length
)
public final function GetChars (
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

パラメータ

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

戻り値

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

例外

例外の種類 条件
System.IndexOutOfRangeException

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

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

解説

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

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

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

スレッド セーフ

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

プラットフォーム

開発プラットフォーム

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

対象プラットフォーム

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

参照

関連項目

AdomdDataReader Class
AdomdDataReader Members
Microsoft.AnalysisServices.AdomdClient Namespace