RFX_Text

Datos de CString de las transferencias entre los miembros de datos de campo de un objeto de CRecordset y columnas de un registro en el origen de datos de tipo SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, o SQL_NUMERICde ODBC.

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

Parámetros

  • pFX
    Un puntero a un objeto de la clase CFieldExchange.Este objeto contiene información para definir el contexto para cada llamada de función.Para obtener más información sobre las operaciones que un objeto de CFieldExchange puede especificar, vea el artículo Intercambio de campos de registros: Funcionamiento de RFX.

  • szName
    El nombre de una columna de datos.

  • valor
    El valor almacenado en el miembro de datos indicado — el valor que se transferirá.Para una transferencia de conjunto de registros al origen de datos, el valor, de CStringcon tipo, se toma del miembro de datos especificado.Para una transferencia del origen de datos al conjunto de registros, el valor se almacena en el miembro de datos especificado.

  • nMaxLength
    El máximo permitido la longitud de la cadena o matriz que se transfieren.El valor predeterminado de nMaxLength es 255.Los valores válidos son 1 a INT_MAX.El marco asigna esta cantidad de espacio para los datos.Para obtener el máximo rendimiento, pase un valor lo suficientemente grande para alojar el elemento de datos más grande que espera.

  • nColumnType
    Se utiliza principalmente para los parámetros.Un entero que indica el tipo de datos del parámetro.El tipo es un tipo de datos de ODBC del formulario SQL_XXX.

  • nScale
    Especifica la escala para los valores de tipo SQL_DECIMAL o SQL_NUMERICde ODBC.nScale solamente es útil al establecer los valores de parámetro.Para obtener más información, vea el tema “Precisión, escala, Longitud, y el tamaño de la pantalla” en el apéndice d de referencia de ODBC en el CD.

Comentarios

Los datos del origen de datos de todos estos tipos se asigna a y desde CString en el conjunto de registros.

Ejemplo

Este ejemplo muestra varias llamadas a RFX_Text.Observe también las dos llamadas a CFieldExchange::SetFieldType.Para los parámetros debe escribir la llamada a SetFieldType y su llamada RFX.La llamada de la columna de salida y sus llamadas asociado RFX están escritas normalmente por un asistente 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);
}

Requisitos

Header: afxdb.h

Vea también

Referencia

RFX_Bool

RFX_Long

RFX_Int

RFX_Single

RFX_Double

RFX_Date

RFX_Byte

RFX_Binary

RFX_LongBinary

CFieldExchange::SetFieldType

Conceptos

Macros y funciones globales de MFC