DFX_Text

Artykuł
02/27/2013

Transfery CString danych między członkami danych pola CDaoRecordset obiektu i kolumny rekordu w źródle danych.

void AFXAPI DFX_Text(
   CDaoFieldExchange* pFX,
   LPCTSTR szName,
   CString& value,
   int nPreAllocSize = AFX_DAO_TEXT_DEFAULT_SIZE,
   DWORD dwBindOptions = AFX_DAO_ENABLE_FIELD_CACHE 
);

Parametry

pFX
Wskaźnik do obiektu klasy CDaoFieldExchange.Ten obiekt zawiera informacje definiujące kontekst dla każdego wywołania funkcji.
szName
Nazwa kolumny danych.
wartość
Wartość przechowywaną w Członkowskie wskazane danych — wartość do przeniesienia.W przypadku przeniesienia z zestawu rekordów do źródła danych, wartości typu CString, jest pobierana z Członkowskich określone dane.Transferu ze źródła danych do zestawu rekordów wartość jest przechowywana w Członkowskich określone dane.
nPreAllocSize
Ramy preallocates to ilość pamięci.Jeśli dane są większe, ramy zostaną przydzielone więcej miejsca, w razie potrzeby.Lepszą wydajność należy ustawić rozmiar wystarczająco duży, aby zapobiec przeniesieniom wartość.
dwBindOptions
Opcja pozwala wykorzystać zalety MFC firmy podwójnego buforowania mechanizm wykrywania pól rekordów, które uległy zmianie.Domyślnie, AFX_DAO_ENABLE_FIELD_CACHE, używa podwójne buforowanie.Możliwe wartości to AFX_DAO_DISABLE_FIELD_CACHE.Jeżeli określono wartość ta MFC nie bez sprawdzania, w tym polu.Musisz wywołać SetFieldDirty i SetFieldNull samodzielnie.

[!UWAGA]

Można kontrolować, czy dane są podwójne buforowana domyślnie, ustawiając CDaoRecordset::m_bCheckCacheForDirtyFields.

Uwagi

Danych jest mapowany między typu DAO_CHAR w DAO (lub, jeśli symbol _UNICODE jest zdefiniowany, DAO_WCHAR) i typu CString w zestawie rekordów.

Przykład

W tym przykładzie przedstawiono kilka wywołań do DFX_Text.Zawiadomienie również dwa połączenia do CDaoFieldExchange::SetFieldType.Należy napisać pierwsze wywołanie SetFieldType i jego DFX wywołania.Drugie wywołanie i jego skojarzony DFX wywołania są zwykle zapisywane przez kreatora kod, który wygenerował klasy.

void CCustSet::DoFieldExchange(CDaoFieldExchange* pFX)
{
   pFX->SetFieldType(CDaoFieldExchange::param);
   DFX_Text(pFX, _T("Param"), m_strParam);
   pFX->SetFieldType(CDaoFieldExchange::outputColumn);
   DFX_Short(pFX, _T("EmployeeID"), m_EmployeeID);
   DFX_Text(pFX, _T("LastName"), m_LastName);
   DFX_Short(pFX, _T("Age"), m_Age);
   DFX_DateTime(pFX, _T("hire_date"), m_hire_date);
   DFX_DateTime(pFX, _T("termination_date"), m_termination_date);

   CDaoRecordset::DoFieldExchange(pFX);
}