다음을 통해 공유

Api.JetEnumerateColumns 메서드

  • 아티클

커서의 현재 레코드 또는 해당 커서의 복사 버퍼에서 열 집합과 해당 값을 효율적으로 검색합니다. 검색된 열 및 값은 열 ID, itagSequence 숫자 및 기타 특성 목록으로 제한할 수 있습니다. 이 열 검색 API는 사용자가 제공한 재할당 호환 콜백을 사용하여 가져온 동적으로 할당된 메모리에 정보를 반환한다는 측면에서 고유합니다. 이 새로운 유연성을 통해 호출자에게 알려지지 않은 특정 특성(예: 크기 및 곱하기)을 사용하여 열 데이터를 효율적으로 검색할 수 있습니다. 이렇게 하면 원하는 데이터를 성공적으로 검색할 JetRetrieveColumn에 대한 최종 호출을 설정하기 위해 JetRetrieveColumn의 검색 모드를 사용하여 이러한 특성을 확인할 필요가 없습니다.

이 API는 CLS 규격이 아닙니다. 

네임스페이스:Microsoft.Isam.Esent.Interop
어셈블리: Microsoft.Isam.Esent.Interop(Microsoft.Isam.Esent.Interop.dll)

구문

'Declaration
<CLSCompliantAttribute(False)> _
Public Shared Function JetEnumerateColumns ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    numColumnids As Integer, _
    columnids As JET_ENUMCOLUMNID(), _
    <OutAttribute> ByRef numColumnValues As Integer, _
    <OutAttribute> ByRef columnValues As JET_ENUMCOLUMN(), _
    allocator As JET_PFNREALLOC, _
    allocatorContext As IntPtr, _
    maxDataSize As Integer, _
    grbit As EnumerateColumnsGrbit _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim numColumnids As Integer
Dim columnids As JET_ENUMCOLUMNID()
Dim numColumnValues As Integer
Dim columnValues As JET_ENUMCOLUMN()
Dim allocator As JET_PFNREALLOC
Dim allocatorContext As IntPtr
Dim maxDataSize As Integer
Dim grbit As EnumerateColumnsGrbit
Dim returnValue As JET_wrn

returnValue = Api.JetEnumerateColumns(sesid, _
    tableid, numColumnids, columnids, _
    numColumnValues, columnValues, allocator, _
    allocatorContext, maxDataSize, grbit)

[CLSCompliantAttribute(false)]
public static JET_wrn JetEnumerateColumns(
    JET_SESID sesid,
    JET_TABLEID tableid,
    int numColumnids,
    JET_ENUMCOLUMNID[] columnids,
    out int numColumnValues,
    out JET_ENUMCOLUMN[] columnValues,
    JET_PFNREALLOC allocator,
    IntPtr allocatorContext,
    int maxDataSize,
    EnumerateColumnsGrbit grbit
)

매개 변수

  • numColumnids
    형식: System.Int32

    JET_ENUMCOLUMNIDS 수입니다.

  • columnids
    형식: []

    열거할 itagSequence 숫자의 선택적 배열이 있는 열 ID의 선택적 배열입니다.

  • numColumnValues
    형식: System.Int32

    검색된 열 값의 수를 반환합니다.

  • columnValues
    형식: []

    열거 열 값을 반환합니다.

  • allocatorContext
    형식: System.IntPtr

    할당 콜백에 대한 컨텍스트입니다.

  • maxDataSize
    형식: System.Int32

    긴 텍스트 또는 긴 이진 열에서 반환할 데이터 양에 대한 상한을 설정합니다. 이 매개 변수는 매우 큰 열 값의 열거를 방지하는 데 사용할 수 있습니다.

반환 값

형식: Microsoft.Isam.Esent.Interop.JET_wrn
경고 또는 성공입니다.

추가 정보

참조

Api 클래스

Api 멤버

Microsoft.Isam.Esent.Interop 네임스페이스