Metode Api.JetRetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, Byte , Int32, Int32, Int32, RetrieveColumnGrbit, JET_RETINFO)

Artikel
06/12/2023

Mengambil nilai kolom tunggal dari rekaman saat ini. Catatan adalah rekaman yang terkait dengan entri indeks pada posisi kursor saat ini. Atau, fungsi ini dapat mengambil kolom dari rekaman yang dibuat di buffer salinan kursor. Fungsi ini juga dapat mengambil data kolom dari entri indeks yang mereferensikan rekaman saat ini. Selain mengambil nilai kolom aktual, JetRetrieveColumn juga dapat digunakan untuk mengambil ukuran kolom, sebelum mengambil data kolom itu sendiri sehingga buffer aplikasi dapat berukuran tepat.

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

Sintaks

'Declaration
Public Shared Function JetRetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    data As Byte(), _
    dataSize As Integer, _
    dataOffset As Integer, _
    <OutAttribute> ByRef actualDataSize As Integer, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As JET_wrn
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim data As Byte()
Dim dataSize As Integer
Dim dataOffset As Integer
Dim actualDataSize As Integer
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As JET_wrn

returnValue = Api.JetRetrieveColumn(sesid, _
    tableid, columnid, data, dataSize, _
    dataOffset, actualDataSize, grbit, _
    retinfo)

public static JET_wrn JetRetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    byte[] data,
    int dataSize,
    int dataOffset,
    out int actualDataSize,
    RetrieveColumnGrbit grbit,
    JET_RETINFO retinfo
)

Parameter

sesid
Jenis: Microsoft.Isam.Esent.Interop.JET_SESID

Sesi yang akan digunakan.

tableid
Jenis: Microsoft.Isam.Esent.Interop.JET_TABLEID

Kursor untuk mengambil kolom.

columnid
Jenis: Microsoft.Isam.Esent.Interop.JET_COLUMNID

Columnid yang akan diambil.

data
Jenis: []

Buffer data yang akan diambil.

dataSize
Jenis: System.Int32

Ukuran buffer data.

himpunan data
Jenis: System.Int32

Offset ke dalam buffer data untuk membaca data.

actualDataSize
Jenis: System.Int32

Mengembalikan ukuran aktual buffer data.

grbit
Jenis: Microsoft.Isam.Esent.Interop.RetrieveColumnGrbit

Mengambil opsi kolom.

retinfo
Jenis: Microsoft.Isam.Esent.Interop.JET_RETINFO

Jika pretinfo diberikan sebagai NULL maka fungsi berperilaku seolah-olah itagSequence 1 dan ibLongValue 0 (nol) diberikan. Ini menyebabkan pengambilan kolom mengambil nilai pertama kolom multinilai, dan mengambil data panjang pada offset 0 (nol).