RFX_Text

Articolo
03/05/2013

Dati di CString di trasferimenti tra i membri dati di campo di un oggetto di CRecordset e le colonne di un record nell'origine dati del tipo SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, o SQL_NUMERICODBC.

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

Parametri

pFX
Un puntatore a un oggetto di classe CFieldExchange.Questo oggetto contiene le informazioni per definire il contesto per ogni chiamata di funzione.Per ulteriori informazioni sulle operazioni che un oggetto di CFieldExchange possibile specificare, vedere l'articolo Trasferimento di campi di Record: Funzionamento di RFX.
szName
Il nome di una colonna di dati.
corrispondente
Il valore memorizzato nel membro dati visualizzato al valore da trasferire.Per un trasferimento dal recordset nell'origine dati, il valore, di tipo CString, viene ricavato dal membro dati specificato.Per un trasferimento dall'origine dati del recordset, il valore verrà memorizzato nel membro dati specificato.
nMaxLength
La lunghezza massima concedere di stringa o della matrice che verranno trasferiti.Il valore predefinito di nMaxLength è 255.I valori consentiti sono 1 a INT_MAX.Il framework alloca la quantità di spazio per i dati.Per prestazioni ottimali, passare un valore abbastanza grande da contenere il massimo elemento di dati che previsti.
nColumnType
Utilizzato principalmente per i parametri.Un intero che indica il tipo di dati del parametro.Il tipo è un tipo di dati ODBC del form SQL_XXX.
nScale
Specifica la scala dei valori del tipo SQL_DECIMAL o SQL_NUMERICODBC.nScale è utile solo quando imposta i valori del parametro.Per ulteriori informazioni, vedere l'argomento “precisione, scala, lunghezza e dimensioni di visualizzazione„ presente nell'appendice D di ODBC programmer's reference SDK.

Note

I dati dell'origine dati di tutti questi tipi vengono mappati a CString nel recordset.

Esempio

Questo esempio mostra diverse chiamate a RFX_Text.Avviso anche le due chiamate a CFieldExchange::SetFieldType.Per i parametri è necessario scrivere la chiamata a SetFieldType e la chiamata a RFX.La chiamata della colonna di output e le relative chiamate a RFX in genere vengono scritte da una creazione guidata codice.

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