SqlDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) 메서드

정의

중요

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

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

public:
 virtual long GetBytes(int ordinal, long fieldOffset, cli::array <System::Byte> ^ buffer, int bufferOffset, int length);

public virtual long GetBytes (int ordinal, long fieldOffset, byte[] buffer, int bufferOffset, int length);

abstract member GetBytes : int * int64 * byte[] * int * int -> int64
override this.GetBytes : int * int64 * byte[] * int * int -> int64

Public Overridable Function GetBytes (ordinal As Integer, fieldOffset As Long, buffer As Byte(), bufferOffset As Integer, length As Integer) As Long

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

바이트 검색을 시작할 필드 값에 대한 오프셋입니다.

바이트를 복사할 대상 버퍼입니다.

바이트 복사를 시작할 버퍼에 대한 오프셋입니다.

버퍼에 복사할 바이트 수입니다.

Int64

복사한 바이트 수입니다.

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

ordinal로 지정된 열이 null인 경우

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

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

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