RFX_Text

Статья
06/10/2015

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

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