IDataRecord.GetBytes 메서드
지정된 버퍼 오프셋에서 시작하여 지정된 열 오프셋의 바이트 스트림을 버퍼에 배열로 읽어 들입니다.
네임스페이스: System.Data
어셈블리: System.Data(system.data.dll)
구문
‘선언
Function GetBytes ( _
i As Integer, _
fieldOffset As Long, _
buffer As Byte(), _
bufferoffset As Integer, _
length As Integer _
) As Long
‘사용 방법
Dim instance As IDataRecord
Dim i As Integer
Dim fieldOffset As Long
Dim buffer As Byte()
Dim bufferoffset As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetBytes(i, fieldOffset, buffer, bufferoffset, length)
long GetBytes (
int i,
long fieldOffset,
byte[] buffer,
int bufferoffset,
int length
)
long long GetBytes (
int i,
long long fieldOffset,
array<unsigned char>^ buffer,
int bufferoffset,
int length
)
long GetBytes (
int i,
long fieldOffset,
byte[] buffer,
int bufferoffset,
int length
)
function GetBytes (
i : int,
fieldOffset : long,
buffer : byte[],
bufferoffset : int,
length : int
) : long
매개 변수
- i
0부터 시작하는 열 서수입니다.
- fieldOffset
읽기 작업을 시작할 필드 내에 있는 인덱스입니다.
- buffer
바이트 스트림을 읽어올 버퍼입니다.
- bufferoffset
읽기 작업을 시작할 buffer의 인덱스입니다.
- length
읽을 바이트의 수입니다.
반환 값
읽은 실제 바이트 수를 반환합니다.
예외
| 예외 형식 | 조건 |
|---|---|
전달된 인덱스가 0에서 FieldCount 사이의 범위에 속하지 않는 경우 |
설명
GetBytes는 필드에서 사용 가능한 바이트의 수를 반환합니다. 이것은 주로 필드의 길이에 해당합니다. 그러나 필드에서 바이트를 얻는 데 GetBytes가 이미 사용되었으면, 반환된 숫자가 실제 필드의 길이보다 작을 수도 있습니다.
Null 참조(Visual Basic의 경우 Nothing)인 버퍼를 전달하면 GetBytes는 행 길이를 바이트 단위로 반환합니다.
변환이 이루어지지 않으므로 검색된 데이터는 이미 바이트 배열이어야 합니다.
플랫폼
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
2.0, 1.1, 1.0에서 지원
.NET Compact Framework
2.0, 1.0에서 지원