다음을 통해 공유


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

정의

지정한 열 오프셋에서 지정한 버퍼 오프셋에서 시작하는 버퍼 배열로 바이트의 스트림을 참고합니다.

public:
 override long GetBytes(int i, long dataIndex, cli::array <System::Byte> ^ buffer, int bufferIndex, int length);
public override long GetBytes (int i, long dataIndex, byte[] buffer, int bufferIndex, int length);
override this.GetBytes : int * int64 * byte[] * int * int -> int64
Public Overrides Function GetBytes (i As Integer, dataIndex As Long, buffer As Byte(), bufferIndex As Integer, length As Integer) As Long

매개 변수

i
Int32

열 서수(0부터 시작)입니다.

dataIndex
Int64

읽기 작업을 시작할 필드 내의 인덱스입니다.

buffer
Byte[]

바이트 스트림을 읽을 버퍼입니다.

bufferIndex
Int32

쓰기 작업을 시작할 buffer 내 인덱스입니다.

length
Int32

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

반환

읽은 실제 바이트 수입니다.

구현

설명

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

인 버퍼를 전달하면 버퍼 nullGetBytes 오프셋 매개 변수를 기반으로 하는 나머지 크기가 아니라 전체 필드의 길이를 바이트 단위로 반환합니다.

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

적용 대상