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 .SetBookmark
GetBookmark
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.