RFX_Text

Artigo
02/25/2013

Transferências de CString dados entre os membros de dados de campo de um CRecordset objeto e colunas de um registro na fonte de dados do tipo ODBC SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, ou SQL_NUMERIC.

void RFX_Text(
   CFieldExchange* pFX,
   const char* szName,
   CString& value,
   int nMaxLength = 255,
   int nColumnType = SQL_VARCHAR,
   short nScale = 0 
);

Parâmetros

pFX
Um ponteiro para um objeto da classe CFieldExchange.Este objeto contém informações para definir o contexto de cada chamada da função.Para obter mais informações sobre as operações de uma CFieldExchange objeto pode especificar, consulte o artigo registro de campo Exchange: como RFX funciona.
szName
O nome de uma coluna de dados.
valor
O valor armazenado no membro de dados indicado — o valor a ser transferido.Para uma transferência de conjunto de registros à fonte de dados, o valor do tipo CString, é obtido do membro de dados especificado.Para uma transferência de fonte de dados ao conjunto de registros, o valor é armazenado no membro de dados especificado.
nMaxLength
O comprimento máximo permitido da cadeia de caracteres ou matriz sendo transferidos.O valor padrão para nMaxLength é 255.Os valores válidos são 1 a INT_MAX.A estrutura aloca essa quantidade de espaço de dados.Para melhor desempenho, passe um valor grande o suficiente para acomodar o item de dados maior que o esperado.
nColumnType
Usado principalmente para parâmetros.Um inteiro indicando o tipo de dados do parâmetro.O tipo é um tipo de dados ODBC do formulário SQL_XXX.
nScale
Especifica a escala de valores do tipo ODBC SQL_DECIMAL ou SQL_NUMERIC.nScalesó é útil ao definir valores de parâmetro.Para obter mais informações, consulte o tópico "Precisão, escala, comprimento e tamanho de exibição" no Apêndice D do referência do programador de ODBC SDK.

Comentários

Dados na fonte de dados de todos esses tipos são mapeados de e para CString no conjunto de registros.

Exemplo

Este exemplo mostra várias chamadas para RFX_Text.Observe também as duas chamadas para CFieldExchange::SetFieldType.Parâmetros, você deve escrever a chamada para SetFieldType e sua chamada RFX.A chamada de coluna de saída e suas chamadas RFX associadas normalmente são escritas por um Assistente de código.

void CCustomer::DoFieldExchange(CFieldExchange* pFX)
{
   pFX->SetFieldType(CFieldExchange::outputColumn);
   // Macros such as RFX_Text() and RFX_Int() are dependent on the
   // type of the member variable, not the type of the field in the database.
   // ODBC will try to automatically convert the column value to the requested type
   RFX_Long(pFX, _T("[CustomerID]"), m_CustomerID);
   RFX_Text(pFX, _T("[ContactFirstName]"), m_ContactFirstName);
   RFX_Text(pFX, _T("[PostalCode]"), m_PostalCode);
   RFX_Text(pFX, _T("[L_Name]"), m_L_Name);
   RFX_Long(pFX, _T("[BillingID]"), m_BillingID);

   pFX->SetFieldType(CFieldExchange::inputParam);
   RFX_Text(pFX, _T("Param"), m_strParam);
}