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
유형: Int32
검색할 열의 서수 위치(0부터 시작)입니다.
- fieldOffset
유형: Int64
데이터 읽기를 시작할 열 내의 인덱스(0부터 시작)입니다.
- buffer
유형: array<Char[]
문자 스트림을 읽을 버퍼입니다.
- bufferoffset
유형: Int32
데이터 쓰기를 시작할 버퍼 내의 인덱스(0부터 시작)입니다.
- length
유형: Int32
열에서 읽을 문자 수입니다.
반환 값
유형: Int64
열에서 실제로 읽는 문자 수를 포함하는 Long입니다.
구현
IDataRecordGetChars(Int32, Int64, Char, Int32, Int32)
예외
| 예외 | 조건 |
|---|---|
| [IndexOutOfRangeException] | dataIndex의 값은 Int32.MaxValue보다 큽니다. bufferIndex의 값은 0보다 작거나 length 및 buffer의 길이 합계보다 큽니다. 이 예외에 대한 자세한 내용은 IndexOutOfRangeException Class를 참조하십시오. |
주의
GetChars 메서드는 필드에 사용할 수 있는 문자 수를 반환합니다. 대부분의 경우 필드의 정확한 길이입니다. 하지만 필드에서 문자를 가져오기 위해 GetChars가 이미 사용된 경우에는 반환된 숫자가 실제 필드 길이보다 작을 수 있습니다.
buffer 매개 변수에 null 참조(Microsoft Visual Basic의 Nothing)를 전달하면 GetBytes가 열 길이(문자 수)를 반환합니다.
변환이 수행되지 않으므로 검색된 데이터는 이미 문자 배열이어야 합니다.