Méthode Api.JetRetrieveColumn (JET_SESID, JET_TABLEID, JET_COLUMNID, Byte , Int32, Int32, Int32, RetrieveColumnGrbit, JET_RETINFO)

Article
06/12/2023

Récupère une valeur de colonne unique de l’enregistrement actif. L’enregistrement est l’enregistrement associé à l’entrée d’index à la position actuelle du curseur. Cette fonction peut également récupérer une colonne à partir d’un enregistrement en cours de création dans la mémoire tampon de copie du curseur. Cette fonction peut également récupérer des données de colonne à partir d’une entrée d’index qui fait référence à l’enregistrement actif. En plus de récupérer la valeur de colonne réelle, JetRetrieveColumn peut également être utilisé pour récupérer la taille d’une colonne, avant de récupérer les données de colonne proprement dites afin que les mémoires tampons d’application puissent être dimensionnées de manière appropriée.

Espace de noms :Microsoft.Isam.Esent.Interop
Assemblée: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Syntaxe

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

Paramètres

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

Session à utiliser.

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

Curseur à partir duquel récupérer la colonne.

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

Columnid à récupérer.

data
Type : []

Mémoire tampon de données dans laquelle récupérer.

dataSize
Type : System.Int32

Taille de la mémoire tampon de données.

dataOffset
Type : System.Int32

Décalage dans la mémoire tampon de données dans laquelle lire les données.

actualDataSize
Type : System.Int32

Retourne la taille réelle de la mémoire tampon de données.

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

Récupérer les options de colonne.

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

Si pretinfo est donné en tant que NULL, la fonction se comporte comme si une itagSequence de 1 et une ibLongValue de 0 (zéro) avaient été données. Cela entraîne la récupération de colonne pour récupérer la première valeur d’une colonne à valeurs multiples et récupérer des données longues au décalage 0 (zéro).