OdbcDataReader.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 particular buffer offset.

public:
 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);
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

매개 변수

i
Int32

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

dataIndex
Int64

읽기 작업을 시작할 행 내 인덱스입니다.The index within the row where the read operation is to start.

buffer
Char[]

데이터를 복사해 올 버퍼입니다.The buffer into which to copy data.

bufferIndex
Int32

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

length
Int32

읽을 문자 수입니다.The number of characters to read.

반환

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

설명

GetChars 필드에 사용할 수 있는 문자 수를 반환합니다.GetChars returns the number of available characters in the field. 대부분의 경우이 값은 필드의 정확한 길이입니다.Most of the time 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. 때문일 경우 예를 들어 경우는 OdbcDataReader 버퍼로 큰 데이터 구조를 읽고 있습니다.This may be the case, for example, if the OdbcDataReader is reading a large data structure into a buffer. 자세한 내용은 참조는 SequentialAccess 에 대 한 설정 CommandBehavior합니다.For more information, see the SequentialAccess setting for CommandBehavior.

버퍼를 null 값을 전달 하는 경우 GetChars 필드의 길이 문자 단위로 반환 합니다.If you pass a buffer that is a null value, GetChars returns the length of the field in characters.

변환이는 ODBC 드라이버의 기본 기능에 따라 수행 됩니다.Conversions are performed based on the underlying capabilities of the ODBC driver. 변환이 지원 되지 않는 경우 메서드 호출이 실패 합니다.If the conversion is not supported then the method call will fail.

참고

하면 예외가 throw 됩니다 값 bufferIndex 배열 밖에 있습니다.No exception will be thrown if the value of bufferIndex is outside the array. 없는 데이터를 읽 및 메서드는 0을 반환 합니다.No data will be read and the method will return 0.

적용 대상

추가 정보