指定された列の値のストリームを示す 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 より小さいか、または length と buffer の長さの合計より大きくなっています。 この例外の詳細については、「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