CDBVariant, classe

Représente un type de données variant pour les classes ODBC MFC.

Syntaxe

class CDBVariant

Membres

Constructeurs publics

Nom Description
CDBVariant ::CDBVariant Construit un objet CDBVariant.

Méthodes publiques

Nom Description
CDBVariant ::Clear Efface l’objet CDBVariant .

Membres de données publics

Nom Description
CDBVariant ::m_dwType Contient le type de données de la valeur actuellement stockée. Tapez DWORD.

Membres de l’Union publique

Nom Description
CDBVariant ::m_boolVal Contient une valeur de type BOOL.
CDBVariant ::m_chVal Contient une valeur de type unsigned char.
CDBVariant ::m_dblVal Contient une valeur de type double.
CDBVariant ::m_fltVal Contient une valeur de type float.
CDBVariant ::m_iVal Contient une valeur de type short.
CDBVariant ::m_lVal Contient une valeur de type long.
CDBVariant ::m_pbinary Contient un pointeur vers un objet de type CLongBinary.
CDBVariant ::m_pdate Contient un pointeur vers un objet de type TIMESTAMP_STRUCT.
CDBVariant ::m_pstring Contient un pointeur vers un objet de type CString.
CDBVariant ::m_pstringA Stocke un pointeur vers un objet CString ASCII.
CDBVariant ::m_pstringW Stocke un pointeur vers un objet CString large.

Notes

CDBVariant n’a pas de classe de base.

CDBVariant est similaire à COleVariant ; toutefois, CDBVariant n’utilise pas OLE. CDBVariant vous permet de stocker une valeur sans vous soucier du type de données de la valeur. CDBVariant suit le type de données de la valeur actuelle, qui est stockée dans une union.

La classe CRecordset utilise des CDBVariant objets dans trois fonctions membres : GetFieldValue, et .SetBookmarkGetBookmark Par exemple, GetFieldValue vous pouvez extraire dynamiquement des données dans une colonne. Étant donné que le type de données de la colonne peut ne pas être connu au moment de l’exécution, GetFieldValue utilise un CDBVariant objet pour stocker les données de la colonne.

Hiérarchie d'héritage

CDBVariant

Spécifications

En-tête : afxdb.h

CDBVariant ::CDBVariant

Crée un objet NULL CDBVariant .

CDBVariant();

Notes

Définit le membre de données m_dwType sur DBVT_NULL.

CDBVariant ::Clear

Appelez cette fonction membre pour effacer l’objet CDBVariant .

void Clear();

Notes

Si la valeur du membre de données m_dwType est DBVT_DATE, DBVT_STRING ou DBVT_BINARY, Clear libère la mémoire associée au membre du pointeur union. Clear définit m_dwType la valeur DBVT_NULL.

Le CDBVariant destructeur appelle Clear.

CDBVariant ::m_boolVal

Stocke une valeur de type BOOL.

Notes

Le m_boolVal membre de données appartient à une union. Avant d’accéder m_boolVal, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType la valeur est définie sur DBVT_BOOL, m_boolVal elle contient une valeur valide ; sinon, l’accès m_boolVal produit des résultats non fiables.

CDBVariant ::m_chVal

Stocke une valeur de type unsigned char.

Notes

Le m_chVal membre de données appartient à une union. Avant d’accéder m_chVal, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_UCHAR, m_chVal contient une valeur valide ; sinon, l’accès m_chVal produit des résultats non fiables.

CDBVariant ::m_dblVal

Stocke une valeur de type double.

Notes

Le m_dblVal membre de données appartient à une union. Avant d’accéder m_dblVal, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_DOUBLE, contient m_dblVal une valeur valide ; sinon, l’accès m_dblVal produit des résultats non fiables.

CDBVariant ::m_dwType

Ce membre de données contient le type de données de la valeur actuellement stockée dans le membre de données d’union de l’objet CDBVariant .

Notes

Avant d’accéder à cette union, vous devez vérifier la valeur pour déterminer le membre de m_dwType données de l’union auquel accéder. Le tableau suivant répertorie les valeurs possibles pour m_dwType et le membre de données d’union correspondant.

m_dwType Membre de données de l’union
DBVT_NULL Aucun membre de l’union n’est valide pour l’accès.
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

Stocke une valeur de type float.

Notes

Le m_fltVal membre de données appartient à une union. Avant d’accéder m_fltVal, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_SINGLE, m_fltVal contient une valeur valide ; sinon, l’accès m_fltVal produit des résultats non fiables.

CDBVariant ::m_iVal

Stocke une valeur de type short.

Notes

Le m_iVal membre de données appartient à une union. Avant d’accéder m_iVal, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_SHORT, m_iVal contient une valeur valide ; sinon, l’accès m_iVal génère des résultats non fiables.

CDBVariant ::m_lVal

Stocke une valeur de type long.

Notes

Le m_lVal membre de données appartient à une union. Avant d’accéder m_lVal, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_LONG, m_lVal contient une valeur valide ; sinon, l’accès m_lVal génère des résultats non fiables.

CDBVariant ::m_pbinary

Stocke un pointeur vers un objet de type CLongBinary.

Notes

Le m_pbinary membre de données appartient à une union. Avant d’accéder m_pbinary, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_BINARY, contient m_pbinary un pointeur valide ; sinon, l’accès m_pbinary produit des résultats non fiables.

CDBVariant ::m_pdate

Stocke un pointeur vers un objet de type TIMESTAMP_STRUCT.

Notes

Le m_pdate membre de données appartient à une union. Avant d’accéder m_pdate, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_DATE, contient m_pdate un pointeur valide ; sinon, l’accès m_pdate génère des résultats non fiables.

Pour plus d’informations sur le type de données TIMESTAMP_STRUCT, consultez la rubrique C Data Types in Annexe D of the ODBC Programmer’s Reference in the Windows SDK.

CDBVariant ::m_pstring

Stocke un pointeur vers un objet de type CString.

Notes

Le m_pstring membre de données appartient à une union. Avant d’accéder m_pstring, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_STRING, contient m_pstring un pointeur valide ; sinon, l’accès m_pstring génère des résultats non fiables.

CDBVariant ::m_pstringA

Stocke un pointeur vers un objet CString ASCII.

Notes

Le m_pstringA membre de données appartient à une union. Avant d’accéder m_pstringA, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_ASTRING, contient m_pstringA un pointeur valide ; sinon, l’accès m_pstringA produit des résultats non fiables.

CDBVariant ::m_pstringW

Stocke un pointeur vers un objet CString large.

Notes

Le m_pstringW membre de données appartient à une union. Avant d’accéder m_pstringW, vérifiez d’abord la valeur de CDBVariant ::m_dwType. Si m_dwType elle est définie sur DBVT_WSTRING, contient m_pstringW un pointeur valide ; sinon, l’accès m_pstringW génère des résultats non fiables.

Voir aussi

Graphique hiérarchique
CRecordset, classe