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)

예외

주의

GetChars 메서드는 필드에 사용할 수 있는 문자 수를 반환합니다. 대부분의 경우 필드의 정확한 길이입니다. 하지만 필드에서 문자를 가져오기 위해 GetChars가 이미 사용된 경우에는 반환된 숫자가 실제 필드 길이보다 작을 수 있습니다.

buffer 매개 변수에 null 참조(Microsoft Visual Basic의 Nothing)를 전달하면 GetBytes가 열 길이(문자 수)를 반환합니다.

변환이 수행되지 않으므로 검색된 데이터는 이미 문자 배열이어야 합니다.

참고 항목

참조

AdomdDataReader 클래스

Microsoft.AnalysisServices.AdomdServer 네임스페이스