다음을 통해 공유


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

정의

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

public:
 override long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public:
 virtual 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);
public long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
override this.GetChars : int * int64 * char[] * int * int -> int64
abstract member GetChars : int * int64 * char[] * int * int -> int64
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
Public 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

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

반환

읽은 실제 문자 수입니다.

구현

설명

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

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

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

참고

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

적용 대상

추가 정보