RFX_Text

Articolo
06/10/2015

I 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 ODBC digitare SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, o SQL_NUMERIC.

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 della funzione. Per ulteriori informazioni sulle operazioni che un oggetto di CFieldExchange può 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 il valore da trasferire. Per un trasferimento dal recordset nell'origine dati, il valore, di tipo CString, vengono forniti dal membro dati specificato. Per un trasferimento dall'origine dati del recordset, il valore verrà memorizzato nel membro dati specificato.
nMaxLength
La lunghezza massima consentita della stringa o della matrice da trasferire. Il valore predefinito di nMaxLength è 255. I valori validi sono 1 a INT_MAX. Il framework alloca la quantità di spazio per i dati. Per ottimizzare le prestazioni, passare un valore abbastanza grande da contenere il più grande elemento di dati come previsto.
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_NUMERIC oDBC. nScale è utile solo quando imposta i valori dei parametri. Per ulteriori informazioni, vedere l'argomento "precisione, scala, lunghezza e dimensioni di visualizzazione" nell'appendice D di ODBC SDK programmer's reference.

Note

I dati dell'origine dati di tutti questi tipi sono mappati a e da CString il 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 collegate vengono generalmente 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);
}