CDaoRecordset::IsFieldNull

[アーティクル]
08/09/2011

レコードセットの指定したフィールドデータメンバーが NULL かどうかを調べます。

BOOL IsFieldNull(
   void* pv 
);

パラメーター

pv
状態を調べるフィールドデータメンバーへのポインター。NULL のフィールドがあるかどうかを調べるには NULL を指定します。

戻り値

指定されたフィールドデータメンバーが NULL の場合は 0 以外の値を返します。それ以外の場合は 0 を返します。

解説

(C++ での NULL とは異なり、データベースの専門用語では、NULL は "値を持たない" ことを意味します。)フィールドデータメンバーが NULL の場合は、現在のレコードの列には値がないと解釈されます。

注意

次のコードで示されているように、IsFieldNull の使用が効果的ではない場合もあります。

COleVariant varValue;
void* pField = &(rs.m_Age);
int nField = 2;

// this code is inefficient because data
// must be retrieved for both IsFieldNull
// and GetFieldValue
if (!rs.IsFieldNull(pField))
   rs.GetFieldValue(nField, varValue);

// this code is more efficient
rs.GetFieldValue(nField, varValue);
if (varValue.vt == VT_NULL)
   varValue.Attach(varNewVal);// do something

注意

CDaoRecordset からクラスを派生せずに、ダイナミックレコード連結を使用する場合は、例のように VT_NULL を使用します。