Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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.