言語
カーソルの現在のレコードまたはそのカーソルのコピー バッファーから、一連の列とその値を効率的に取得します。 取得される列と値は、列 ID、itagSequence 番号、およびその他の特性の一覧によって制限できます。 この列取得 API は、ユーザー指定の realloc 互換コールバックを使用して取得された動的に割り当てられたメモリ内の情報を返すという点で一意です。 この新しい柔軟性により、呼び出し元に不明な特定の特性 (サイズや多重度など) を持つ列データを効率的に取得できます。 これにより、JetRetrieveColumn の探索モードを使用して、目的のデータを正常に取得する JetRetrieveColumn への最終的な呼び出しを設定するために、これらの特性を決定する必要がなくなります。
この API は CLS 準拠ではありません。
Namespace:Microsoft.Isam.Esent.Interop
アセンブリ： Microsoft.Isam.Esent.Interop (Microsoft.Isam.Esent.Interop.dll)
構文
'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
)
パラメーター
sesid
種類: Microsoft.Isam.Esent.Interop.JET_SESID使用するセッション。
tableid
種類: Microsoft.Isam.Esent.Interop.JET_TABLEIDデータを取得するカーソル。
numColumnids
種類: System.Int32JET_ENUMCOLUMNIDSの数。
columnids
型: []列 ID の省略可能な配列。各列には、列挙する itagSequence 番号の省略可能な配列が含まれます。
numColumnValues
種類: System.Int32取得した列値の数を返します。
columnValues
型: []列挙列の値を返します。
allocator
種類: Microsoft.Isam.Esent.Interop.JET_PFNREALLOCメモリの割り当てに使用されるコールバック。
allocatorContext
種類: System.IntPtr割り当てコールバックのコンテキスト。
maxDataSize
種類: System.Int32長いテキストまたは長いバイナリ列から返されるデータの量に上限を設定します。 このパラメーターを使用すると、列の値が非常に大きくなるのを防ぐことができます。
grbit
種類: Microsoft.Isam.Esent.Interop.EnumerateColumnsGrbitオプションを取得します。
戻り値
種類: Microsoft.Isam.Esent.Interop.JET_wrn
警告または成功。