CFieldExchange::SetFieldType

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

オーバーライドしたレコードセットクラスの DoFieldExchange または DoBulkFieldExchange で、SetFieldType を呼び出す必要があります。

void SetFieldType(
   UINT nFieldType 
);

パラメータ

nFieldType
次に示す CFieldExchange で宣言されている enum FieldType の値のいずれかを指定します。
- CFieldExchange::outputColumn
- CFieldExchange::inputParam
- CFieldExchange::param
- CFieldExchange::outputParam
- CFieldExchange::inoutParam

解説

フィールドデータメンバの場合、RFX または Bulk RFX 関数の前に、CFieldExchange::outputColumn のパラメータで SetFieldType を呼び出す必要があります。バルク行フェッチを実装していない場合、ClassWizard が DoFieldExchange のフィールドマップセクションに SetFieldType 関数呼び出しを記述します。

レコードセットクラスをパラメータ化するときは、フィールドマップセクションの外側で、すべてのパラメータデータメンバの RFX 呼び出しの前に、再度 SetFieldType を呼び出す必要があります。パラメータデータメンバの型ごとに SetFieldType 関数呼び出しを追加する必要があります。自分のクラスのパラメータデータメンバを指定するために SetFieldType 関数に渡せる値は、次の表のとおりです。

SetFieldType パラメータ値	パラメータデータメンバの型
CFieldExchange::inputParam	入力パラメータ。値はレコードセットのクエリまたは組み込み手続きへ渡されます。
CFieldExchange::param	CFieldExchange::inputParam と同じです。
CFieldExchange::outputParam	出力パラメータ。レコードセットの組み込み手続きの戻り値です。
CFieldExchange::inoutParam	入出力パラメータ。レコードセットの組み込み手続きへ渡された、またはそこから返された値です。

一般的には、フィールドデータメンバやパラメータデータメンバに関連付けられた一連の RFX 関数呼び出しの前に、SetFieldType 関数を呼び出す必要があります。それぞれの SetFieldType 呼び出しのパラメータ nFieldType は、その後に続く RFX 関数呼び出しで示されるデータメンバの型を識別します。

出力と入出力パラメータの取り扱いの詳細については、CRecordset の「CRecordset::FlushResultSet」メンバ関数を参照してください。RFX と Bulk RFX 関数の詳細については、「レコードフィールドエクスチェンジ (RFX) 関数」を参照してください。バルク行フェッチの関連情報については、「レコードセット : バルク行フェッチ (ODBC)」を参照してください。

使用例

この例では、SetFieldType 関数の呼び出しを組み合わせたいくつかの RFX 関数の呼び出しを示します。SetFieldType 関数は CFieldExchange オブジェクトへのポインタ pFX を使って呼び出されます。

void CSections::DoFieldExchange(CFieldExchange* pFX)
{
    pFX->SetFieldType(CFieldExchange::outputColumn);
    RFX_Text(pFX, _T("[CourseID]"), m_CourseID);
    RFX_Text(pFX, _T("[InstructorID]"), m_InstructorID);
    RFX_Text(pFX, _T("[RoomNo]"), m_RoomNo);
    RFX_Text(pFX, _T("[Schedule]"), m_Schedule);

   // output parameter
   pFX->SetFieldType(CFieldExchange::outputParam);
   RFX_Long(pFX, _T("Instructor_Count"), m_nCountParam);

   // input parameter
   pFX->SetFieldType(CFieldExchange::inputParam);
   RFX_Text(pFX, _T("Department_Name"), m_strNameParam);
}