Api.RetrieveColumn 方法 (JET_SESID、JET_TABLEID、JET_COLUMNID、RetrieveColumnGrbit、JET_RETINFO)

發行項
06/12/2023

從目前記錄擷取單一資料行值。記錄是與游標目前位置之索引項目目相關聯的記錄。或者，此函式可以從資料指標複製緩衝區中建立的記錄擷取資料行。此函式也可以從參考目前記錄的索引項目目擷取資料行資料。除了擷取實際的資料行值之外，JetRetrieveColumn 也可以用來擷取資料行的大小，再擷取資料行資料本身，以便適當地調整應用程式緩衝區的大小。

Namespace：Microsoft.Isam.Esent.Interop
裝配： Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

語法

'Declaration
Public Shared Function RetrieveColumn ( _
    sesid As JET_SESID, _
    tableid As JET_TABLEID, _
    columnid As JET_COLUMNID, _
    grbit As RetrieveColumnGrbit, _
    retinfo As JET_RETINFO _
) As Byte()
'Usage
Dim sesid As JET_SESID
Dim tableid As JET_TABLEID
Dim columnid As JET_COLUMNID
Dim grbit As RetrieveColumnGrbit
Dim retinfo As JET_RETINFO
Dim returnValue As Byte()

returnValue = Api.RetrieveColumn(sesid, _
    tableid, columnid, grbit, retinfo)

public static byte[] RetrieveColumn(
    JET_SESID sesid,
    JET_TABLEID tableid,
    JET_COLUMNID columnid,
    RetrieveColumnGrbit grbit,
    JET_RETINFO retinfo
)

參數

sesid
類型： Microsoft.Isam.Esent.Interop.JET_SESID

要使用的會話。

tableid
類型： Microsoft.Isam.Esent.Interop.JET_TABLEID

要從中擷取資料行的資料指標。

columnid
類型： Microsoft.Isam.Esent.Interop.JET_COLUMNID

要擷取的 columnid。

grbit
類型： Microsoft.Isam.Esent.Interop.RetrieveColumnGrbit

擷取資料行選項。

retinfo
類型： Microsoft.Isam.Esent.Interop.JET_RETINFO

如果 pretinfo 是指定為 Null，則函式的行為就像是 1 的 itagSequence，而 ibLongValue 為 0 (零) 。這會導致資料行擷取多值資料行的第一個值，並在位移 0 (零) 擷取長資料。