レコードセットのフィールド データ メンバーに、変更の有無を示すフラグを設定します。
void SetFieldDirty(
void* pv,
BOOL bDirty = TRUE
);
パラメーター
pv
レコードセットのフィールド データ メンバーのアドレス、または NULL。 NULL を指定したときは、レコードセットのすべてのフィールド データ メンバーにフラグがセットされます。 (データベースの専門用語の NULL とは異なり、C++ の NULL は、"値を持たない" ことを意味します。)bDirty
TRUE を指定すると、フィールド データ メンバーは "ダーティ" (変更されている) としてマークされます。 FALSE を指定すると、フィールド データ メンバーは "クリーン" (変更されていない) としてマークされます。
解説
フィールドが変更されていないとマークされている場合、そのフィールドは更新されていないことを示します。
フレームワークは変更されたフィールド データ メンバーをマークし、DAO レコード フィールド エクスチェンジ (DFX) 機構がデータ ソースのレコードに書き込むようにします。 フィールドの値を変更すると、通常、フィールドは自動的にダーティに設定されます。したがって、SetFieldDirty 関数を呼び出す必要はほとんどありません。しかし、フィールド データ メンバーの値にかかわらず列を明示的に更新または挿入する必要がある場合は、SetFieldDirty 関数を呼び出します。 DFX 機構では PSEUDO NULL も使用できます。 詳細については、「CDaoFieldExchange::m_nOperation」を参照してください。
ダブル バッファリング機構が使用されていない場合、フィールドの値が変更されても、自動的にダーティとして設定されません。 この場合、フィールドを明示的にダーティとしてマークする必要があります。 フィールドの自動チェックは、m_bCheckCacheForDirtyFields が保持するフラグによって制御されます。
関数の最初の引数に NULL を指定すると、CDaoFieldExchange の param フィールドではなく、すべての outputColumns フィールドに関数が適用されます。 呼び出し形式は、次のとおりです。
SetFieldDirty(NULL);
は、outputColumns フィールドのみに NULL をセットし、param フィールドには影響を与えません。
param に対する設定には、次のように設定する param の実際のアドレスを渡す必要があります。
SetFieldDirty(&m_strParam);
これは、outputColumn フィールドとは異なり、すべての param フィールドを同時に NULL に設定できないことを意味します。
SetFieldDirty は、DoFieldExchange によって実装されています。
必要条件
**ヘッダー:**afxdao.h