RFX_Text

Статья
02/20/2013

Сведения о CString переключений между элементами данных полей объекта CRecordset и столбцами записи в источнике данных типа SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL или SQL_NUMERIC ODBC.

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

Параметры

pFX
Указатель на объект класса CFieldExchange.Этот объект содержит сведения для определения контекста для каждого вызова функции.Дополнительные сведения об операциях объект CFieldExchange может определить см. в статье Обмен полями записей: Принцип работы RFX.
szName
Имя столбца данных.
значение
Значение, хранящееся в заданном элементе данных — значение, которое необходимо передать.Для переключения из набора записей к источнику данных значение типа CString, берется из указанного элемента данных.Для передачи из источника данных в набор записей, значение сохраняется в указанном элементе данных.
nMaxLength
Максимально допустимая длина передаваемых строки или массива.Значение по умолчанию для типа nMaxLength равно 255.Допустимые значения от 1 до INT_MAX.Платформа выберите это объем пространства для данных.Для наилучшей производительности, передайте значение достаточно большое, чтобы обеспечить самый крупный элемент данных ожидается.
nColumnType
Используется в основном для параметров.Целое число, указывающее тип данных параметра.Тип данных ODBC формы SQL_XXX.
nScale
Определяет масштаб для значений типа SQL_DECIMAL или SQL_NUMERIC ODBC.nScale полезно только при установке значения параметров.Дополнительные сведения см. в подразделе «точность, масштаб, длину и размер отображения» D приложения ссылки программиста ODBC SDK.

Заметки

Данные в источнике данных всех этих типов сопоставляются с CString в наборе записей.

Пример

В этом примере показано несколько вызовов RFX_Text.Уведомление также 2 вызова метода CFieldExchange::SetFieldType.Для параметров необходимо написать вызов SetFieldType и его вызову функций RFX.Вызов выходного столбца и связанные с ним вызовы функций RFX обычно записываются мастером кода.

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