RFX_Text

Artykuł
06/10/2015

Transfery CString danych między członkami danych pola CRecordset obiektu i kolumn rekordu w źródle danych ODBC typu SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMAL, lub SQL_NUMERIC.

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

Parametry

pFX
Wskaźnik do obiektu klasy CFieldExchange.Ten obiekt zawiera informacje, aby zdefiniować kontekst dla każdego wywołania funkcji.Aby uzyskać więcej informacji na temat operacji CFieldExchange obiektu można określić, zapoznaj się z artykułem wymiany pól rekordu: jak działa RFX.
szName
Nazwa kolumny danych.
wartość
Wartość przechowywana w elemencie danych wskazany — wartości mają zostać przeniesione.W przypadku przeniesienia z zestawu rekordów do źródła danych, wartość typu CString, jest pobierana z danych określonego elementu członkowskiego.W przypadku przeniesienia ze źródła danych do zestawu rekordów wartość jest przechowywana w danych określony element członkowski.
nMaxLength
Maksymalna dozwolona długość ciągu lub tablicy przenoszonymi danymi.Domyślna wartość nMaxLength wynosi 255.Wartości prawne są 1 do INT_MAX.Ramach przydziela to ilość miejsca dla danych.Aby uzyskać najlepszą wydajność należy przekazać wartość wystarczająco duży, aby pomieścić największą element danych, można się spodziewać.
nColumnType
Używany głównie dla parametrów.Liczba całkowita wskazująca typ danych parametru.Typem jest typ danych ODBC formularza SQL_XXX.
nScale
Określa skalę dla wartości typu ODBC SQL_DECIMAL lub SQL_NUMERIC.nScalejest przydatna podczas ustawiania wartości parametrów.Aby uzyskać więcej informacji, zobacz temat "Precyzja, skala, długość i rozmiar wyświetlania" w dodatku D SDK Podręcznik programisty ODBC.

Uwagi

Dane w źródle danych wszystkich tych typów jest mapowany do i z CString w zestawie rekordów.

Przykład

W tym przykładzie przedstawiono kilka wywołań do RFX_Text.Należy zauważyć również dwóch połączeń do CFieldExchange::SetFieldType.Dla parametrów, należy napisać wywołanie SetFieldType i jego wywołania RFX.Wywołanie kolumny danych wyjściowych i jego skojarzony wywołania RFX normalnie są pisane przez kreatora kodu.

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