Класс CDBVariant

Представляет вариантный тип данных для классов MFC ODBC.

Синтаксис

class CDBVariant

Участники

Открытые конструкторы

Имя	Описание
CDBVariant::CDBVariant	Формирует объект CDBVariant.

Открытые методы

Имя	Описание
CDBVariant::Clear	Очищает CDBVariant объект.

Открытые члены данных

Имя	Описание
CDBVariant::m_dwType	Содержит тип данных текущего сохраненного значения. Введите DWORD.

Члены общественного союза

Имя	Описание
CDBVariant::m_boolVal	Содержит значение типа BOOL.
CDBVariant::m_chVal	Содержит значение типа unsigned char.
CDBVariant::m_dblVal	Содержит значение типа double.
CDBVariant::m_fltVal	Содержит значение типа float.
CDBVariant::m_iVal	Содержит значение типа short.
CDBVariant::m_lVal	Содержит значение типа long.
CDBVariant::m_pbinary	Содержит указатель на объект типа CLongBinary.
CDBVariant::m_pdate	Содержит указатель на объект типа TIMESTAMP_STRUCT.
CDBVariant::m_pstring	Содержит указатель на объект типа CString.
CDBVariant::m_pstringA	Сохраняет указатель на объект CString ASCII.
CDBVariant::m_pstringW	Сохраняет указатель на широкий объект CString .

Замечания

CDBVariant не имеет базового класса.

CDBVariant аналогично COleVariant; однако CDBVariant не использует OLE. CDBVariant позволяет хранить значение, не беспокоясь о типе данных значения. CDBVariant отслеживает тип данных текущего значения, который хранится в союзе.

Класс CRecordset использует CDBVariant объекты в трех функциях-членах: GetFieldValue, GetBookmarkи SetBookmark. Например, GetFieldValue можно динамически получить данные в столбце. Так как тип данных столбца может не быть известен во время выполнения, GetFieldValue использует CDBVariant объект для хранения данных столбца.

Иерархия наследования

CDBVariant

Требования

Заголовок: afxdb.h

CDBVariant::CDBVariant

Создает объект NULL CDBVariant .

CDBVariant();

Замечания

Задает элемент данных m_dwType DBVT_NULL.

CDBVariant::Clear

Вызовите эту функцию-член, чтобы очистить CDBVariant объект.

void Clear();

Замечания

Если значение элемента данных m_dwType равно DBVT_DATE, DBVT_STRING или DBVT_BINARY, Clear освобождает память, связанную с элементом указателя объединения. Clear задает m_dwType значение DBVT_NULL.

CDBVariant Вызовы Clearдеструктора.

CDBVariant::m_boolVal

Сохраняет значение типа BOOL.

Замечания

Член m_boolVal данных принадлежит к союзу. Перед доступом m_boolValсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_BOOL, то m_boolVal будет содержать допустимое значение; в противном случае доступ m_boolVal приведет к ненадежным результатам.

CDBVariant::m_chVal

Сохраняет значение типа unsigned char.

Замечания

Член m_chVal данных принадлежит к союзу. Перед доступом m_chValсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_UCHAR, m_chVal то содержит допустимое значение; в противном случае доступ m_chVal приведет к ненадежным результатам.

CDBVariant::m_dblVal

Сохраняет значение типа double.

Замечания

Член m_dblVal данных принадлежит к союзу. Перед доступом m_dblValсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_DOUBLE, m_dblVal то содержит допустимое значение; в противном случае доступ m_dblVal приведет к ненадежным результатам.

CDBVariant::m_dwType

Этот элемент данных содержит тип данных для значения, которое в настоящее время хранится в CDBVariant члене данных объединения объекта.

Замечания

Перед доступом к этому союзу необходимо проверить значение m_dwType для определения элемента данных объединения для доступа. В следующей таблице перечислены возможные значения и m_dwType соответствующий член данных объединения.

m_dwType	Член данных объединения
DBVT_NULL	Для доступа не является допустимым членом профсоюза.
DBVT_BOOL	m_boolVal
DBVT_UCHAR	m_chVal
DBVT_SHORT	m_iVal
DBVT_LONG	m_lVal
DBVT_SINGLE	m_fltVal
DBVT_DOUBLE	m_dblVal
DBVT_DATE	m_pdate
DBVT_STRING	m_pstring
DBVT_BINARY	m_pbinary
DBVT_ASTRING	m_pstringA
DBVT_WSTRING	m_pstringW

CDBVariant::m_fltVal

Сохраняет значение типа float.

Замечания

Член m_fltVal данных принадлежит к союзу. Перед доступом m_fltValсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_SINGLE, m_fltVal то содержит допустимое значение; в противном случае доступ m_fltVal приведет к ненадежным результатам.

CDBVariant::m_iVal

Сохраняет значение типа short.

Замечания

Член m_iVal данных принадлежит к союзу. Перед доступом m_iValсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_SHORT, m_iVal то содержит допустимое значение; в противном случае доступ m_iVal приведет к ненадежным результатам.

CDBVariant::m_lVal

Сохраняет значение типа long.

Замечания

Член m_lVal данных принадлежит к союзу. Перед доступом m_lValсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_LONG, m_lVal то содержит допустимое значение; в противном случае доступ m_lVal приведет к ненадежным результатам.

CDBVariant::m_pbinary

Сохраняет указатель на объект типа CLongBinary.

Замечания

Член m_pbinary данных принадлежит к союзу. Перед доступом m_pbinaryсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_BINARY, m_pbinary то содержит допустимый указатель; в противном случае доступ m_pbinary приведет к ненадежным результатам.

CDBVariant::m_pdate

Сохраняет указатель на объект типа TIMESTAMP_STRUCT.

Замечания

Член m_pdate данных принадлежит к союзу. Перед доступом m_pdateсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_DATE, m_pdate то содержит допустимый указатель; в противном случае доступ m_pdate приведет к ненадежным результатам.

Дополнительные сведения о типе данных TIMESTAMP_STRUCT см. в разделе "Типы данных C" в приложении D справочника программиста ODBC в пакете SDK для Windows.

CDBVariant::m_pstring

Сохраняет указатель на объект типа CString.

Замечания

Член m_pstring данных принадлежит к союзу. Перед доступом m_pstringсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_STRING, m_pstring то содержит допустимый указатель; в противном случае доступ m_pstring приведет к ненадежным результатам.

CDBVariant::m_pstringA

Сохраняет указатель на объект CString ASCII.

Замечания

Член m_pstringA данных принадлежит к союзу. Перед доступом m_pstringAсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_ASTRING, m_pstringA то содержит допустимый указатель; в противном случае доступ m_pstringA приведет к ненадежным результатам.

CDBVariant::m_pstringW

Сохраняет указатель на широкий объект CString .

Замечания

Член m_pstringW данных принадлежит к союзу. Перед доступом m_pstringWсначала проверьте значение CDBVariant::m_dwType. Если m_dwType задано значение DBVT_WSTRING, m_pstringW то содержит допустимый указатель; в противном случае доступ m_pstringW приведет к ненадежным результатам.

См. также

Диаграмма иерархии
Класс CRecordset