CDBVariant (clase)

Representa un tipo de datos variant para las clases ODBC de MFC.

Sintaxis

class CDBVariant

Miembros

Constructores públicos

Nombre	Descripción
CDBVariant::CDBVariant	Construye un objeto CDBVariant.

Métodos públicos

Nombre	Descripción
CDBVariant::Clear	Borra el objeto CDBVariant.

Miembros de datos públicos

Nombre	Descripción
CDBVariant::m_dwType	Contiene el tipo de datos del valor almacenado actualmente. Escriba DWORD.

Miembros de la unión pública

Nombre	Descripción
CDBVariant::m_boolVal	Contiene un valor de tipo BOOL.
CDBVariant::m_chVal	Contiene un valor de tipo unsigned char.
CDBVariant::m_dblVal	Contiene un valor de tipo double.
CDBVariant::m_fltVal	Contiene un valor de tipo float.
CDBVariant::m_iVal	Contiene un valor de tipo short.
CDBVariant::m_lVal	Contiene un valor de tipo long.
CDBVariant::m_pbinary	Contiene un puntero a un objeto de tipo CLongBinary.
CDBVariant::m_pdate	Contiene un puntero a un objeto de tipo TIMESTAMP_STRUCT.
CDBVariant::m_pstring	Contiene un puntero a un objeto de tipo CString.
CDBVariant::m_pstringA	Almacena un puntero a un objeto CString ASCII.
CDBVariant::m_pstringW	Almacena un puntero a un objeto CString amplio.

Comentarios

CDBVariant no tiene una clase base.

CDBVariant es similar a COleVariant; sin embargo, CDBVariant no usa OLE. CDBVariant le permite almacenar un valor sin preocuparse por el tipo de datos del valor. CDBVariant realiza un seguimiento del tipo de datos del valor actual, que se almacena en una unión.

La clase CRecordset utiliza CDBVariant objetos en tres funciones miembro: GetFieldValue, GetBookmark y SetBookmark. Por ejemplo, GetFieldValue le permite capturar datos dinámicamente en una columna. Dado que es posible que el tipo de datos de la columna no se conozca en tiempo de ejecución, GetFieldValue usa un objeto CDBVariant para almacenar los datos de la columna.

Jerarquía de herencia

CDBVariant

Requisitos

Encabezado: afxdb.h

CDBVariant::CDBVariant

Crea un objeto CDBVariant NULL.

CDBVariant();

Comentarios

Establece el miembro de datos m_dwType en DBVT_NULL.

CDBVariant::Clear

Llame a esta función miembro para borrar el objeto CDBVariant.

void Clear();

Comentarios

Si el valor del miembro de datos m_dwType es DBVT_DATE, DBVT_STRING o DBVT_BINARY, Clear libera la memoria asociada al miembro de puntero de unión. Clear establece m_dwType en DBVT_NULL.

El destructor CDBVariant llama a Clear.

CDBVariant::m_boolVal

Especifica un valor de tipo BOOL.

Comentarios

El miembro de datos m_boolVal pertenece a una unión. Antes de acceder a m_boolVal, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_BOOL, m_boolVal contendrá un valor válido; de lo contrario, el acceso a m_boolVal generará resultados no confiables.

CDBVariant::m_chVal

Almacena un valor de tipo unsigned char.

Comentarios

El miembro de datos m_chVal pertenece a una unión. Antes de acceder a m_chVal, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_UCHAR, m_chVal contendrá un valor válido; de lo contrario, el acceso a m_chVal generará resultados no confiables.

CDBVariant::m_dblVal

Almacena un valor de tipo double.

Comentarios

El miembro de datos m_dblVal pertenece a una unión. Antes de acceder a m_dblVal, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_DOUBLE, m_dblVal contendrá un valor válido; de lo contrario, el acceso a m_dblVal generará resultados no confiables.

CDBVariant::m_dwType

Este miembro de datos contiene el tipo de datos para el valor que está almacenado actualmente en el miembro de datos de unión del objeto CDBVariant.

Comentarios

Antes de acceder a esta unión, debe comprobar el valor de m_dwType para determinar a qué miembro de datos de unión acceder. En la tabla siguiente se enumeran los valores posibles para m_dwType y el miembro de datos de unión correspondiente.

m_dwType	Miembros de datos de unión
DBVT_NULL	Ningún miembro de la unión es válido para el acceso.
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

Almacena un valor de tipo float.

Comentarios

El miembro de datos m_fltVal pertenece a una unión. Antes de acceder a m_fltVal, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_SINGLE, m_fltVal contendrá un valor válido; de lo contrario, el acceso a m_fltVal generará resultados no confiables.

CDBVariant::m_iVal

Almacena un valor de tipo short.

Comentarios

El miembro de datos m_iVal pertenece a una unión. Antes de acceder a m_iVal, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_SHORT, m_iVal contendrá un valor válido; de lo contrario, el acceso a m_iVal generará resultados no confiables.

CDBVariant::m_lVal

Almacena un valor de tipo long.

Comentarios

El miembro de datos m_lVal pertenece a una unión. Antes de acceder a m_lVal, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_LONG, m_lVal contendrá un valor válido; de lo contrario, el acceso a m_lVal generará resultados no confiables.

CDBVariant::m_pbinary

Almacena un puntero a un objeto de tipo CLongBinary.

Comentarios

El miembro de datos m_pbinary pertenece a una unión. Antes de acceder a m_pbinary, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_BINARY, m_pbinary contendrá un puntero válido; de lo contrario, el acceso a m_pbinary generará resultados no confiables.

CDBVariant::m_pdate

Almacena un puntero a un objeto de tipo TIMESTAMP_STRUCT.

Comentarios

El miembro de datos m_pdate pertenece a una unión. Antes de acceder a m_pdate, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_DATE, m_pdate contendrá un puntero válido; de lo contrario, el acceso a m_pdate generará resultados no confiables.

Para más información sobre el tipo de datos TIMESTAMP_STRUCT, consulte el tema Tipos de datos de C en el apéndice D de Referencia del programador de ODBC en Windows SDK.

CDBVariant::m_pstring

Almacena un puntero a un objeto de tipo CString.

Comentarios

El miembro de datos m_pstring pertenece a una unión. Antes de acceder a m_pstring, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_STRING, m_pstring contendrá un puntero válido; de lo contrario, el acceso a m_pstring generará resultados no confiables.

CDBVariant::m_pstringA

Almacena un puntero a un objeto CString ASCII.

Comentarios

El miembro de datos m_pstringA pertenece a una unión. Antes de acceder a m_pstringA, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_ASTRING, m_pstringA contendrá un puntero válido; de lo contrario, el acceso a m_pstringA generará resultados no confiables.

CDBVariant::m_pstringW

Almacena un puntero a un objeto CString amplio.

Comentarios

El miembro de datos m_pstringW pertenece a una unión. Antes de acceder a m_pstringW, compruebe primero el valor de CDBVariant::m_dwType. Si m_dwType se establece en DBVT_WSTRING, m_pstringW contendrá un puntero válido; de lo contrario, el acceso a m_pstringW generará resultados no confiables.

Consulte también

Gráfico de jerarquías
CRecordset (clase)