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

정의

지정된 열 오프셋의 바이트 스트림을 지정된 버퍼 오프셋에서 시작하는 버퍼 및 배열로 읽어들입니다.Reads a stream of bytes from the specified column offset into the buffer an array starting at the given buffer offset.

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

매개 변수

i
Int32

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

dataIndex
Int64

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

buffer
Byte[]

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

bufferIndex
Int32

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

length
Int32

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

반환

읽은 실제 바이트 수입니다.The actual number of bytes read.

구현

설명

GetBytes 필드에 사용할 수 있는 바이트 수를 반환합니다.GetBytes returns the number of available bytes in the field. 대부분의 경우이 값은 필드의 정확한 길이입니다.Most of the time this is the exact length of the field. 그러나 반환 된 숫자 보다 작을 수도 있습니다 필드의 길이 경우 GetBytes 바이트를 얻는 필드에서 이미 사용 되었습니다.However, the number returned may be less than the true length of the field if GetBytes has already been used to obtain bytes 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.

null된 버퍼를 전달 하는 경우 GetBytes는 버퍼 오프셋 매개 변수를 기반으로 하는 나머지 크기가 아니라 전체 필드의 길이 (바이트)를 반환 합니다.If you pass a buffer that is null, GetBytes returns the length of the entire field in bytes, not the remaining size based on the buffer offset parameter.

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

적용 대상

추가 정보