RFX_Text

Artikel
02/26/2013

Übergangs- CString Daten zwischen den Felddatenmembern eines CRecordset-Objekts und Spalten eines Datensatzes in der Datenquelle ODBC-Typ SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL oder SQL_NUMERIC.

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

Parameter

pFX
Ein Zeiger auf ein Objekt der Klasse CFieldExchange.Dieses Objekt enthält Informationen, um den Kontext für jeden Aufruf der Funktion zu definieren.Weitere Informationen über die Vorgänge, die ein CFieldExchange-Objekt angeben können, finden Sie im Artikel Datensatzfeldaustausch: Wie Funktionsweise von RFX.
szName
Der Name einer Datenspalte.
Wert
Der Wert, der im angegebenen Datenmember gespeicherten übertragen werden.Für eine Übertragung von Recordsets zu Datenquelle, wird der Wert vom Typ CString, aus dem angegebenen Datenmember gebunden.Für eine Übertragung von Datenquelle Recordsets liegt, wird der Wert im angegebenen Datenmember gespeichert.
nMaxLength
Die maximal zulässige Länge der Zeichenfolge oder des Arrays, die übertragen wird.Der Standardwert von nMaxLength ist 255 (null).Gültige Werte sind 1 bis INT_MAX.Das Framework ordnet diesen Platz für die Daten an.Um eine optimale Leistung übergeben Sie einen Wert, der weit, dass das Element zu groß ist, um das Datenelement.
nColumnType
Wird hauptsächlich für Parameter.Eine ganze Zahl, die den Datentyp des Parameters angibt.Der Typ ist ein SQL_XXX ODBC-Datentyp Formular.
nScale
Gibt die Dezimalstellen für Werte SQL_DECIMAL ODBC-Typ oder SQL_NUMERIC an.nScale ist nur nützlich, wenn Parameterwerte festlegen.Weitere Informationen finden Sie im Thema "Genauigkeit, Dezimalstellen, Länge und Anzeigen-Größe" im Anhang D der ODBC SDK Programmer's Reference.

Hinweise

Daten in der Datenquelle aus allen diese Typen wird in bzw. aus CString im Recordset zugeordnet.

Beispiel

In diesem Beispiel wird RFX_Text mehrere Aufrufe an.Beachten Sie außerdem die beiden Aufrufe CFieldExchange::SetFieldType.Weitere Parameter müssen Sie den Aufruf schreiben SetFieldType und seinem RFX-Aufruf.Der Aufruf der Ausgabespalten und seine zugeordneten RFX-Aufrufe werden normalerweise von einem Code-Assistenten geschrieben.

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