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

정의

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

서수로 지정된 열의 값을 Char 개체의 배열로 가져옵니다.

public:
 virtual long GetChars(int ordinal, long fieldOffset, cli::array <char> ^ buffer, int bufferOffset, int length);

public virtual long GetChars (int ordinal, long fieldOffset, char[] buffer, int bufferOffset, int length);

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

Public Overridable Function GetChars (ordinal As Integer, fieldOffset As Long, buffer As Char(), bufferOffset As Integer, length As Integer) As Long

열의 0부터 시작하는 서수입니다.

문자 검색을 시작할 필드 값에 대한 오프셋입니다.

문자를 복사할 대상 버퍼입니다.

문자 복사를 시작할 버퍼에 대한 오프셋입니다.

버퍼에 복사할 문자 수입니다.

Int64

복사한 문자 수입니다.

ordinal이 0보다 작거나 열 수(즉, FieldCount)보다 큰 경우

ordinal로 지정된 열이 null인 경우

형식이 일치하지 않습니다.

이 메서드를 사용하면 단일 호출 또는 청크에서 문자 값을 가져올 수 있습니다. 청크로 값을 가져오는 것은 큰 값 또는 알 수 없는 크기의 값에 유용합니다.

여러 청크로 값을 가져오려면 청크 크기의 char 배열을 할당하고 각 호출에서 매개 변수를 적절하게 조정하는 를 fieldOffset 반복적으로 호출 GetChars 합니다.