CFieldExchange::SetFieldType

Artigo
06/10/2015

Você precisa de uma chamada a SetFieldType em uma substituição de DoFieldExchange ou de DoBulkFieldExchange de sua classe do conjunto de registros.

void SetFieldType( 
   UINT nFieldType  
);

Parâmetros

nFieldType
Um valor de enum FieldType, declarado em CFieldExchange, que pode ser um dos seguintes:
- CFieldExchange::outputColumn
- CFieldExchange::inputParam
- CFieldExchange::param
- CFieldExchange::outputParam
- CFieldExchange::inoutParam

Comentários

Para membros de dados do campo, você deve chamar SetFieldType com um parâmetro de CFieldExchange::outputColumn, seguido por chamadas para o RFX ou funções em massa de RFX. Se você não tiver implementado a linha em massa que pesquisa, então ClassWizard coloca esta chamada de SetFieldType para você na seção do mapa do campo de DoFieldExchange.

Se você parametrizar sua classe do conjunto de registros, você deve chamar SetFieldType novamente, fora de qualquer seção do mapa de campo, seguido por chamadas de RFX para todos os membros de dados do parâmetro. Cada tipo de membro de dados do parâmetro deve ter seu próprio chamada de SetFieldType . A tabela a seguir faz distinção os valores diferentes que você pode passar a SetFieldType para representar os membros de dados do parâmetro de sua classe:

Valor do parâmetro de SetFieldType	Tipo de membro de dados do parâmetro
CFieldExchange::inputParam	Parâmetro de entrada. Um valor que é passado na consulta ou procedimento armazenado do conjunto de registros.
CFieldExchange::param	Mesmo que CFieldExchange::inputParam.
CFieldExchange::outputParam	Parâmetro de saída. Um valor de retorno do procedimento armazenado do conjunto de registros.
CFieldExchange::inoutParam	Parâmetro de arquivos entrada/saída. Um valor em que é passado e retornado do procedimento armazenado do conjunto de registros.

Geralmente, cada grupo de chamadas de função de RFX associadas aos membros dos membros de dados do campo ou de dados do parâmetro deve ser precedido por uma chamada a SetFieldType. O parâmetro de nFieldType de cada chamada de SetFieldType identifica o tipo dos membros de dados representados pelas chamadas de função de RFX após a chamada de SetFieldType .

Para obter mais informações sobre parâmetros de saída e de arquivos entrada/saída de tratamento, consulte a função de membro FlushResultSetde CRecordset . Para obter mais informações sobre o RFX e funções em massa de RFX, consulte o tópico Registrar funções de Exchange do campo. Para informações sobre relacionada a linha em massa que pesquisa, consulte o artigo conjunto de registros: Para buscar registros em massa (ODBC).

Exemplo

Este exemplo mostra várias chamadas a funções de RFX com rastreamento de chamadas a SetFieldType. Observe que SetFieldType é chamado através do ponteiro de pFX a um objeto de CFieldExchange .

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);
}