Класс CDBVariant

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Представляет вариантный тип данных для классов 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