IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) IDataRecord.GetBytes(Int32, Int64, Byte[], Int32, Int32) Method

정의

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

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

매개 변수

i
Int32 Int32 Int32 Int32

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

fieldOffset
Int64 Int64 Int64 Int64

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

buffer
Byte[]

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

bufferoffset
Int32 Int32 Int32 Int32

읽기 작업을 시작할 buffer에 대한 인덱스입니다.The index for buffer to start the read operation.

length
Int32 Int32 Int32 Int32

읽을 바이트 수입니다.The number of bytes to read.

반환

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

예외

전달된 인덱스가 0부터 FieldCount의 범위를 벗어난 경우The index passed was outside the range of 0 through FieldCount.

설명

GetBytes 필드에 사용할 수 있는 바이트 수를 반환합니다.GetBytes returns the number of available bytes in the field. 자주이 값은 필드의 정확한 길이입니다.Frequently 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.

버퍼를 전달 하는 경우 null, GetBytes 행의 길이 바이트 단위로 반환 합니다.If you pass a buffer that is null, GetBytes returns the length of the row in bytes.

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

적용 대상