Metode Api.JetEnumerateColumns

Secara efisien mengambil sekumpulan kolom dan nilainya dari rekaman kursor saat ini atau penyangga salinan kursor tersebut. Kolom dan nilai yang diambil dapat dibatasi oleh daftar ID kolom, nomor itagSequence, dan karakteristik lainnya. API pengambilan kolom ini unik karena mengembalikan informasi dalam memori yang dialokasikan secara dinamis yang diperoleh menggunakan panggilan balik yang kompatibel dengan realloc yang disediakan pengguna. Fleksibilitas baru ini memungkinkan pengambilan data kolom yang efisien dengan karakteristik tertentu (seperti ukuran dan perkalian) yang tidak diketahui oleh pemanggil. Ini menghilangkan kebutuhan akan penggunaan mode penemuan JetRetrieveColumn untuk menentukan karakteristik tersebut untuk mengatur panggilan akhir ke JetRetrieveColumn yang akan berhasil mengambil data yang diinginkan.

API ini bukan kompatibel CLS. 

Namespace:Microsoft.Isam.Esent.Interop
Majelis: Microsoft.Isam.Esent.Interop (dalam Microsoft.Isam.Esent.Interop.dll)

Sintaks

'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
)

Parameter

  • numColumnids
    Jenis: System.Int32

    Jumlah JET_ENUMCOLUMNIDS.

  • columnids
    Jenis: []

    Array OPSIONAL ID kolom, masing-masing dengan array opsional dari angka itagSequence untuk dijumlahkan.

  • numColumnValues
    Jenis: System.Int32

    Mengembalikan jumlah nilai kolom yang diambil.

  • columnValues
    Jenis: []

    Mengembalikan nilai kolom enumerasi.

  • allocatorContext
    Jenis: System.IntPtr

    Konteks untuk panggilan balik alokasi.

  • maxDataSize
    Jenis: System.Int32

    Mengatur batas pada jumlah data yang akan dikembalikan dari teks panjang atau kolom biner panjang. Parameter ini dapat digunakan untuk mencegah enumerasi nilai kolom yang sangat besar.

Menampilkan nilai

Jenis: Microsoft.Isam.Esent.Interop.JET_wrn
Peringatan atau keberhasilan.

Lihat juga

Referensi

Kelas Api

Anggota api

Namespace Microsoft.Isam.Esent.Interop