RFX_Text

Artigo
08/25/2010

Transfere CString dados entre os membros de dados do 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, or 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 de classe CFieldExchange. Este objeto contém informações para definir o contexto para cada telefonar da função.Para obter mais informações sobre as operações de CFieldExchange objeto pode especificar, consulte o artigo Intercâmbio de campo do registro: Como RFX trabalha.
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 de cadeia de caracteres ou array que está sendo transferido.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 para os dados.Para obter 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 or SQL_NUMERIC.nScale só é útil ao definir valores de parâmetro. Para obter mais informações, consulte o tópico "Precisão, escala, comprimento e dimensionar de exibição" no Apêndice D dosReferência do programador de ODBC SDK.

Comentários

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

Exemplo

Este exemplo mostra várias chamadas para RFX_Text. Observe também os dois planos de CFieldExchange::SetFieldType. Para os parâmetros, você deve escrever a telefonar para SetFieldType e sua telefonar RFX. A telefonar 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);
}