SqlDataReader.GetChars(Int32, Int64, Char[], Int32, Int32) 메서드

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

지정한 버퍼 오프셋에서 시작하여 지정한 열 오프셋의 문자 스트림을 배열로 버퍼에 가져옵니다.

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);

public override long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);

override this.GetChars : int * int64 * char[] * int * int -> int64

Public Overrides Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

매개 변수

i

Int32

열 서수(0부터 시작)입니다.

dataIndex

Int64

읽기 작업을 시작할 필드 내의 인덱스입니다.

buffer

Char[]

바이트 스트림을 읽을 버퍼입니다.

bufferIndex

Int32

쓰기 작업을 시작할 buffer 내 인덱스입니다.

length

Int32

버퍼로 복사할 최대 길이입니다.

반환

Int64

읽은 실제 문자 수입니다.

구현

GetChars(Int32, Int64, Char[], Int32, Int32)

설명

GetChars 필드에 사용할 수 있는 문자 수를 반환합니다. 필드의 정확한 길이인 경우가 종종 있습니다. 그러나 반환 된 숫자 보다 작을 수도 있습니다 필드의 길이 경우 GetChars 필드에서 문자를 가져올 이미 사용 되었습니다. 예를 들어 가 큰 데이터 구조를 버퍼로 읽는 경우 SqlDataReader 일 수 있습니다. 자세한 내용은 에 SequentialAccess 대한 설정을 참조하세요 CommandBehavior.

필드의 끝에 도달한 경우 실제 읽은 문자 수가 요청된 된 길이 보다 작은 수입니다. 인 버퍼를 전달하는 경우 버퍼 nullGetChars 오프셋 매개 변수에 따라 나머지 크기가 아닌 전체 필드의 길이를 문자로 반환합니다.

변환은 수행되지 않습니다. 따라서. 검색된 데이터는 이미 문자 배열이어야 합니다.

참고

메서드는 가 GetChars 음수이면 dataIndex 0을 반환합니다.