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


지정된 버퍼 오프셋에서 시작하는 배열로서 지정된 열 오프셋에서 버퍼로 문자의 스트림을 읽습니다.Reads a stream of characters from the specified column offset into the buffer as an array starting at the given buffer offset.

 virtual long GetChars(int i, long dataIndex, cli::array <char> ^ buffer, int bufferIndex, int length);
public long GetChars (int i, long dataIndex, char[] buffer, int bufferIndex, int length);
abstract member GetChars : int * int64 * char[] * int * int -> int64
override this.GetChars : int * int64 * char[] * int * int -> int64
Public Function GetChars (i As Integer, dataIndex As Long, buffer As Char(), bufferIndex As Integer, length As Integer) As Long

매개 변수


열 서수(0부터 시작)입니다.The zero-based column ordinal.


읽기 작업을 시작하는 필드 내의 인덱스입니다.The index within the field from which to begin the read operation.


바이트 스트림을 읽을 버퍼입니다.The buffer into which to read the stream of bytes.


쓰기 작업을 시작할 buffer 내 인덱스입니다.The index within the buffer where the write operation is to start.


버퍼로 복사할 최대 길이입니다.The maximum length to copy into the buffer.


읽은 실제 문자 수입니다.The actual number of characters read.



GetChars 필드에 사용할 수 있는 문자 수를 반환합니다.GetChars returns the number of available characters in the field. 이는 필드의 정확한 길이에 자주 해당 합니다.Frequently this is the exact length of the field. 그러나 반환 된 숫자 보다 작을 수도 있습니다 필드의 길이 경우 GetChars 필드에서 문자를 가져올 이미 사용 되었습니다.However, the number returned may be less than the true length of the field if GetChars has already been used to obtain characters from the field. 예를 들어 SqlDataReader에서 버퍼에 대 한 대량 데이터 구조를 읽는 경우에 해당 합니다.This may be the case, for example, if the SqlDataReader is reading a large data structure into a buffer. 자세한 내용은 CommandBehavior에 대 한 SequentialAccess 설정을 참조 하세요.For more information, see the SequentialAccess setting for CommandBehavior.

필드의 끝에 도달한 경우 실제 읽은 문자 수가 요청된 된 길이 보다 작은 수입니다.The actual number of characters read can be less than the requested length, if the end of the field is reached. null된 버퍼를 전달 하는 경우 GetChars는 버퍼 오프셋 매개 변수를 기반으로 하는 나머지 크기가 아니라 문자 단위로 전체 필드의 길이를 반환 합니다.If you pass a buffer that is null, GetChars returns the length of the entire field in characters, not the remaining size based on the buffer offset parameter.

변환이 수행 되지 않습니다. 따라서.No conversions are performed; therefore. 검색 된 데이터는 이미 문자 배열 이어야 합니다.the data retrieved must already be a character array.


dataIndex 음수인 경우 GetChars 메서드는 0을 반환 합니다.The GetChars method returns 0 when dataIndex is negative.

적용 대상

추가 정보