Share via


SqlCeResultSet.GetChars 메서드

지정된 필드의 지정된 위치에서 시작하여 문자 단위의 길이를 버퍼에 복사합니다.

네임스페이스:  System.Data.SqlServerCe
어셈블리:  System.Data.SqlServerCe(System.Data.SqlServerCe.dll)

구문

‘선언
Public Overrides Function GetChars ( _
    ordinal As Integer, _
    dataIndex As Long, _
    buffer As Char(), _
    bufferIndex As Integer, _
    length As Integer _
) As Long
‘사용 방법
Dim instance As SqlCeResultSet
Dim ordinal As Integer
Dim dataIndex As Long
Dim buffer As Char()
Dim bufferIndex As Integer
Dim length As Integer
Dim returnValue As Long

returnValue = instance.GetChars(ordinal, _
    dataIndex, buffer, bufferIndex, length)
public override long GetChars(
    int ordinal,
    long dataIndex,
    char[] buffer,
    int bufferIndex,
    int length
)
public:
virtual long long GetChars(
    int ordinal, 
    long long dataIndex, 
    array<wchar_t>^ buffer, 
    int bufferIndex, 
    int length
) override
abstract GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
override GetChars : 
        ordinal:int * 
        dataIndex:int64 * 
        buffer:char[] * 
        bufferIndex:int * 
        length:int -> int64 
public override function GetChars(
    ordinal : int, 
    dataIndex : long, 
    buffer : char[], 
    bufferIndex : int, 
    length : int
) : long

매개 변수

  • ordinal
    유형: System.Int32
    데이터를 검색할 필드의 위치입니다.
  • dataIndex
    유형: System.Int64
    복사를 시작할 원본 필드 내의 오프셋(문자 단위)입니다.
  • buffer
    유형: array<System.Char[]
    데이터를 복사해 넣을 버퍼입니다.
  • bufferIndex
    유형: System.Int32
    복사를 시작할 원본 버퍼 내의 오프셋입니다.
  • length
    유형: System.Int32
    복사할 최대 바이트 수입니다.

반환 값

유형: System.Int64
복사된 실제 문자 수입니다.

구현

IDataRecord.GetChars(Int32, Int64, array<Char[], Int32, Int32)

주의

이 함수는 복사된 실제 문자 수를 반환합니다. 필드 끝에 도달한 경우 이 수는 요청한 길이보다 작을 수 있습니다.

null 버퍼를 전달하면 GetChars에서 필드 길이를 문자 단위로 반환합니다.

SequentialAccess의 명령 동작으로 명령을 실행하는 경우 GetChars를 호출할 때 증가하는 순서대로 읽기를 지정해야 하며, 그렇지 않으면 예외가 throw됩니다.

지정한 서수 위치에 필드가 없으면 예외가 throw됩니다.

참고 항목

참조

SqlCeResultSet 클래스

System.Data.SqlServerCe 네임스페이스