CDaoRecordset::GetFieldValue

2008-09-17

更新 : 2007 年 11 月

レコードセットのデータを取得します。

virtual void GetFieldValue(
   LPCTSTR lpszName,
   COleVariant& varValue 
);
virtual void GetFieldValue(
   int nIndex,
   COleVariant& varValue 
);
virtual COleVariant GetFieldValue(
   LPCTSTR lpszName 
);
virtual COleVariant GetFieldValue(
   int nIndex 
);

パラメータ

lpszName
フィールドの名前を持つ文字列へのポインタ。
varValue
フィールドの値が格納される COleVariant オブジェクトへの参照。
nIndex
インデックスによる検索のための、レコードセット Fields コレクションの 0 から始まるインデックス番号。

戻り値

GetFieldValue の 2 つのバージョンは、フィールドの値が含まれている COleVariant オブジェクトを返します。

解説

フィールドは名前順、または設定した順番で検索できます。

メモ :
COleVariant オブジェクトを返すバージョンを呼び出すより、COleVariant オブジェクトの参照をパラメータとして取るバージョンを呼び出す方が効率は良くなります。この関数の以前のバージョンが下位互換性のために残されています。

DoFieldExchange 機構を使用して、静的にフィールドを連結するのではなく、実行時に動的にフィールドを連結するには、GetFieldValue および SetFieldValue を使用します。

GetFieldValue と DoFieldExchange 機構を組み合わせて、パフォーマンスを向上させることができます。たとえば、そのときだけ必要な値を取得する場合は GetFieldValue を使用し、その呼び出しをインターフェイスの [詳細情報] ボタンに割り当てます。

関連情報については、DAO ヘルプの「Field Object」と「Value Property」を参照してください。