Klasa CDBVariant

Reprezentuje typ danych wariantu dla klas MFC ODBC.

Składnia

class CDBVariant

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CDBVariant::CDBVariant	CDBVariant Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CDBVariant::Clear	Czyści CDBVariant obiekt.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
CDBVariant::m_dwType	Zawiera typ danych aktualnie przechowywanej wartości. Wpisz DWORD.

Członkowie unii publicznej

Nazwa/nazwisko	opis
CDBVariant::m_boolVal	Zawiera wartość typu BOOL.
CDBVariant::m_chVal	Zawiera wartość typu unsigned char.
CDBVariant::m_dblVal	Zawiera wartość typu double.
CDBVariant::m_fltVal	Zawiera wartość typu float.
CDBVariant::m_iVal	Zawiera wartość typu short.
CDBVariant::m_lVal	Zawiera wartość typu long.
CDBVariant::m_pbinary	Zawiera wskaźnik do obiektu typu CLongBinary.
CDBVariant::m_pdate	Zawiera wskaźnik do obiektu typu TIMESTAMP_STRUCT.
CDBVariant::m_pstring	Zawiera wskaźnik do obiektu typu CString.
CDBVariant::m_pstringA	Przechowuje wskaźnik do obiektu CString ASCII.
CDBVariant::m_pstringW	Przechowuje wskaźnik do szerokiego obiektu CString .

Uwagi

CDBVariant nie ma klasy bazowej.

CDBVariant jest podobny do COleVariant; CDBVariant jednak nie używa obiektu OLE. CDBVariant umożliwia przechowywanie wartości bez obaw o typ danych wartości. CDBVariant śledzi typ danych bieżącej wartości, która jest przechowywana w unii.

Klasa CRecordset wykorzystuje CDBVariant obiekty w trzech funkcjach składowych: GetFieldValue, GetBookmarki SetBookmark. Na przykład GetFieldValue umożliwia dynamiczne pobieranie danych w kolumnie. Ponieważ typ danych kolumny może nie być znany w czasie wykonywania, GetFieldValue używa CDBVariant obiektu do przechowywania danych kolumny.

Hierarchia dziedziczenia

CDBVariant

Wymagania

Nagłówek: afxdb.h

CDBVariant::CDBVariant

Tworzy obiekt NULL CDBVariant .

CDBVariant();

Uwagi

Ustawia element członkowski danych m_dwType na DBVT_NULL.

CDBVariant::Clear

Wywołaj tę funkcję składową, aby wyczyścić CDBVariant obiekt.

void Clear();

Uwagi

Jeśli wartość elementu członkowskiego danych m_dwType jest DBVT_DATE, DBVT_STRING lub DBVT_BINARY, Clear zwalnia pamięć skojarzona z elementem członkowskim wskaźnika unii. Clear ustawia m_dwType wartość DBVT_NULL.

Destruktor wywołuje metodę CDBVariantClear.

CDBVariant::m_boolVal

Przechowuje wartość typu BOOL.

Uwagi

Element m_boolVal członkowski danych należy do unii. Przed uzyskaniem m_boolValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType zostanie ustawiona wartość DBVT_BOOL, m_boolVal będzie zawierać prawidłową wartość. W przeciwnym razie uzyskanie m_boolVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_chVal

Przechowuje wartość typu unsigned char.

Uwagi

Element m_chVal członkowski danych należy do unii. Przed uzyskaniem m_chValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_UCHAR, zawiera m_chVal prawidłową wartość. W przeciwnym razie uzyskanie m_chVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_dblVal

Przechowuje wartość typu double.

Uwagi

Element m_dblVal członkowski danych należy do unii. Przed uzyskaniem m_dblValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli ustawiono wartość DBVT_DOUBLE, m_dblVal zawiera prawidłową wartość. W m_dwType przeciwnym razie uzyskanie m_dblVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_dwType

Ten element członkowski danych zawiera typ danych dla wartości, która jest obecnie przechowywana w składowej CDBVariant danych unii obiektu.

Uwagi

Przed uzyskaniem dostępu do tej unii należy sprawdzić wartość m_dwType , aby określić, do którego elementu członkowskiego danych unii uzyskać dostęp. W poniższej tabeli wymieniono możliwe wartości dla m_dwType i odpowiadające mu składowe danych unii.

M_dwtype	Składowa danych unii
DBVT_NULL	Żaden członek unii nie jest ważny w celu uzyskania dostępu.
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

Przechowuje wartość typu float.

Uwagi

Element m_fltVal członkowski danych należy do unii. Przed uzyskaniem m_fltValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_SINGLE, m_fltVal zawiera prawidłową wartość. W przeciwnym razie uzyskanie m_fltVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_iVal

Przechowuje wartość typu short.

Uwagi

Element m_iVal członkowski danych należy do unii. Przed uzyskaniem m_iValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_SHORT, m_iVal zawiera prawidłową wartość. W przeciwnym razie uzyskanie m_iVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_lVal

Przechowuje wartość typu long.

Uwagi

Element m_lVal członkowski danych należy do unii. Przed uzyskaniem m_lValdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_LONG, m_lVal zawiera prawidłową wartość. W przeciwnym razie uzyskanie m_lVal dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_pbinary

Przechowuje wskaźnik do obiektu typu CLongBinary.

Uwagi

Element m_pbinary członkowski danych należy do unii. Przed uzyskaniem m_pbinarydostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_BINARY, m_pbinary zawiera prawidłowy wskaźnik. W przeciwnym razie uzyskanie m_pbinary dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_pdate

Przechowuje wskaźnik do obiektu typu TIMESTAMP_STRUCT.

Uwagi

Element m_pdate członkowski danych należy do unii. Przed uzyskaniem m_pdatedostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_DATE, m_pdate zawiera prawidłowy wskaźnik. W przeciwnym razie uzyskanie m_pdate dostępu spowoduje wygenerowanie niewiarygodnych wyników.

Aby uzyskać więcej informacji na temat typu danych TIMESTAMP_STRUCT, zobacz temat Typy danych języka C w dodatku D dokumentacji programisty ODBC w zestawie Windows SDK.

CDBVariant::m_pstring

Przechowuje wskaźnik do obiektu typu CString.

Uwagi

Element m_pstring członkowski danych należy do unii. Przed uzyskaniem m_pstringdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli ustawiono wartość DBVT_STRING, m_pstring zawiera prawidłowy wskaźnik. W m_dwType przeciwnym razie uzyskanie m_pstring dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_pstringA

Przechowuje wskaźnik do obiektu CString ASCII.

Uwagi

Element m_pstringA członkowski danych należy do unii. Przed uzyskaniem m_pstringAdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli m_dwType ustawiono wartość DBVT_ASTRING, m_pstringA zawiera prawidłowy wskaźnik. W przeciwnym razie uzyskanie m_pstringA dostępu spowoduje wygenerowanie niewiarygodnych wyników.

CDBVariant::m_pstringW

Przechowuje wskaźnik do szerokiego obiektu CString .

Uwagi

Element m_pstringW członkowski danych należy do unii. Przed uzyskaniem m_pstringWdostępu najpierw sprawdź wartość CDBVariant::m_dwType. Jeśli ustawiono wartość DBVT_WSTRING, m_pstringW zawiera prawidłowy wskaźnik. W m_dwType przeciwnym razie uzyskanie m_pstringW dostępu spowoduje wygenerowanie niewiarygodnych wyników.

Zobacz też

Wykres hierarchii
Klasa CRecordset