RFX_Text

Artikel
06/10/2015

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

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. Weitere Informationen über die Vorgänge, die ein CFieldExchange-Objekt angeben kann, finden Sie im Artikel Datensatzfeldaustausch: Wie RFX funktioniert.
szName
Der Name einer Datenspalte.
Wert
Der Wert gespeichert im angegebenen Datenmember - der zu übertragenden Wert. Eine Übertragung vom Recordset zu Datenquelle, wird der Wert, des Typs CString, im angegebenen Datenmember angewendet. Eine Übertragung von Datenquelle zu Recordset, wird der Wert im angegebenen Datenmember gespeichert.
nMaxLength
Die maximale zulässige Länge der Zeichenfolge oder des Arrays, die übertragen wird. Der Standardwert von nMaxLength ist 255 (null). Gültige Werte sind 1 von INT_MAX. Das Framework ordnet diesem Platz für die Daten zu. Für optimale Leistung übergeben Sie einen Wert, der ausreicht, um die größte Datenelement anzupassen groß ist, das Sie erwartet haben.
nColumnType
Wird hauptsächlich für Parameter. Eine ganze Zahl, die dem Datentyp der Parameter angibt. Der Typ ist ein ODBC-Datentyp Formular SQL_XXX.
nScale
Gibt der Skalierung für Werte aus ODBC-Typ SQL_DECIMAL oder SQL_NUMERIC angezeigt. nScale ist nur nützlich, wenn Sie Parameterwerte festgelegt. Weitere Informationen finden Sie im Thema "Länge, Genauigkeit, Dezimalstellen und Anzeigen-Größe" im Anhang D von ODBC Programmer's Reference.

Hinweise

Daten in der Datenquelle aus allen diesen Typen werden in und aus CString im Recordset zugeordnet.

Beispiel

In diesem Beispiel wird RFX_Text mehrere Aufrufe. Begriff auch die beiden Aufrufe von CFieldExchange::SetFieldType. Die Parameter müssen Sie den Aufruf schreiben SetFieldType und seinem RFX-Aufruf. Der Ausgabespaltenaufruf 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);
}