Api.JetRetrieveColumn 方法 (JET_SESID， JET_TABLEID， JET_COLUMNID， Byte ， Int32， Int32， Int32， 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 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
)

參數

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

要使用的會話。

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

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

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

要擷取的 columnid。

資料
類型： []

要擷取到的資料緩衝區。

dataSize
類型： System.Int32

資料緩衝區的大小。

dataOffset
類型： System.Int32

位移至要讀取資料的資料緩衝區。

actualDataSize
類型： System.Int32

傳回資料緩衝區的實際大小。

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

擷取資料行選項。

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

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