IDataRecord.GetChars 메서드
지정된 버퍼 오프셋에서 시작하여 지정된 열 오프셋의 문자 스트림을 버퍼에 배열로 읽어 들입니다.
네임스페이스: System.Data
어셈블리: System.Data(system.data.dll)
구문
‘선언
Function GetChars ( _
i As Integer, _
fieldoffset As Long, _
buffer As Char(), _
bufferoffset As Integer, _
length As Integer _
) As Long
‘사용 방법
Dim instance As IDataRecord
Dim i As Integer
Dim fieldoffset As Long
Dim buffer As Char()
Dim bufferoffset As Integer
Dim length As Integer
Dim returnValue As Long
returnValue = instance.GetChars(i, fieldoffset, buffer, bufferoffset, length)
long GetChars (
int i,
long fieldoffset,
char[] buffer,
int bufferoffset,
int length
)
long long GetChars (
int i,
long long fieldoffset,
array<wchar_t>^ buffer,
int bufferoffset,
int length
)
long GetChars (
int i,
long fieldoffset,
char[] buffer,
int bufferoffset,
int length
)
function GetChars (
i : int,
fieldoffset : long,
buffer : char[],
bufferoffset : int,
length : int
) : long
매개 변수
- i
0부터 시작하는 열 서수입니다.
- fieldoffset
읽기 작업을 시작하는 행 내의 인덱스입니다.
- buffer
바이트 스트림을 읽어올 버퍼입니다.
- bufferoffset
읽기 작업을 시작할 buffer의 인덱스입니다.
- length
읽을 바이트의 수입니다.
반환 값
읽은 실제 문자 수를 반환합니다.
예외
| 예외 형식 | 조건 |
|---|---|
전달된 인덱스가 0에서 FieldCount 사이의 범위에 속하지 않는 경우 |
설명
GetChars는 필드에서 사용 가능한 문자의 수를 반환합니다. 이것은 주로 필드의 길이에 해당합니다. 그러나 GetChars가 이미 필드에서 문자를 가져오는 데 사용된 경우에는 반환된 숫자가 필드의 정확한 길이보다 작을 수도 있습니다.
Null 참조(Visual Basic의 경우 Nothing)인 버퍼를 전달하면 GetChars는 필드 길이를 문자 수 단위로 반환합니다.
변환이 이루어지지 않으므로 검색된 데이터는 이미 문자 배열이어야 합니다.
플랫폼
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에서 지원