Classe CDBVariant

Representa um tipo de dados variante para as classes ODBC do MFC.

Sintaxe

class CDBVariant

Membros

Construtores públicos

Métodos públicos

Membros de Dados Públicos

Membros de união públicos

Comentários

CDBVariant não tem uma classe base.

CDBVariant é semelhante a COleVariant; no entanto, CDBVariant não usa OLE. CDBVariant permite armazenar um valor sem se preocupar com o tipo de dados do valor. CDBVariant rastreia o tipo de dados do valor atual, que é armazenado em uma união.

A classe CRecordset utiliza objetos CDBVariant em três funções membro: GetFieldValue, GetBookmark e SetBookmark. Por exemplo, GetFieldValue permite que você busque dinamicamente dados em uma coluna. Como o tipo de dados da coluna pode não ser conhecido em tempo de execução, GetFieldValue usa um objeto CDBVariant para armazenar os dados da coluna.

Hierarquia de herança

CDBVariant

Requisitos

Cabeçalho: afxdb.h

CDBVariant::CDBVariant

Cria um objeto CDBVariant NULL.

CDBVariant();

Comentários

Define o membro de dados m_dwType como DBVT_NULL.

CDBVariant::Clear

Chame essa função membro para limpar o objeto CDBVariant.

void Clear();

Comentários

Se o valor do membro de dados m_dwType for DBVT_DATE, DBVT_STRING ou DBVT_BINARY, Clear liberará a memória associada ao membro do ponteiro de união. Clear define m_dwType como DBVT_NULL.

O destruidor CDBVariant chama Clear.

CDBVariant::m_boolVal

Armazena um valor do tipo BOOL.

Comentários

O membro de dados m_boolVal pertence a uma união. Antes de acessar m_boolVal, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_BOOL, m_boolVal conterá um valor válido; caso contrário, o acesso a m_boolVal produzirá resultados não confiáveis.

CDBVariant::m_chVal

Armazena um valor do tipo unsigned char.

Comentários

O membro de dados m_chVal pertence a uma união. Antes de acessar m_chVal, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_UCHAR, m_chVal conterá um valor válido; caso contrário, o acesso a m_chVal produzirá resultados não confiáveis.

CDBVariant::m_dblVal

Armazena um valor do tipo double.

Comentários

O membro de dados m_dblVal pertence a uma união. Antes de acessar m_dblVal, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_DOUBLE, m_dblVal conterá um valor válido; caso contrário, o acesso a m_dblVal produzirá resultados não confiáveis.

CDBVariant::m_dwType

Esse membro de dados contém o tipo de dados do valor armazenado atualmente no membro de dados da união do objeto CDBVariant.

Comentários

Antes de acessar essa união, você deve verificar o valor de m_dwType para determinar qual membro de dados da união acessar. A tabela a seguir lista os valores possíveis de m_dwType e o membro de dados da união correspondente.

CDBVariant::m_fltVal

Armazena um valor do tipo float.

Comentários

O membro de dados m_fltVal pertence a uma união. Antes de acessar m_fltVal, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_SINGLE, m_fltVal conterá um valor válido; caso contrário, o acesso a m_fltVal produzirá resultados não confiáveis.

CDBVariant::m_iVal

Armazena um valor do tipo short.

Comentários

O membro de dados m_iVal pertence a uma união. Antes de acessar m_iVal, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_SHORT, m_iVal conterá um valor válido; caso contrário, o acesso a m_iVal produzirá resultados não confiáveis.

CDBVariant::m_lVal

Armazena um valor do tipo long.

Comentários

O membro de dados m_lVal pertence a uma união. Antes de acessar m_lVal, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_LONG, m_lVal conterá um valor válido; caso contrário, o acesso a m_lVal produzirá resultados não confiáveis.

CDBVariant::m_pbinary

Armazena um ponteiro para um objeto do tipo CLongBinary.

Comentários

O membro de dados m_pbinary pertence a uma união. Antes de acessar m_pbinary, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_BINARY, m_pbinary conterá um ponteiro válido; caso contrário, o acesso a m_pbinary produzirá resultados não confiáveis.

CDBVariant::m_pdate

Armazena um ponteiro para um objeto do tipo TIMESTAMP_STRUCT.

Comentários

O membro de dados m_pdate pertence a uma união. Antes de acessar m_pdate, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_DATE, m_pdate conterá um ponteiro válido; caso contrário, o acesso a m_pdate produzirá resultados não confiáveis.

Para obter mais informações sobre o tipo de dados TIMESTAMP_STRUCT, consulte o tópico Tipos de Dados C no Apêndice D da Referência do Programador do ODBC no SDK do Windows.

CDBVariant::m_pstring

Armazena um ponteiro para um objeto do tipo CString.

Comentários

O membro de dados m_pstring pertence a uma união. Antes de acessar m_pstring, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_STRING, m_pstring conterá um ponteiro válido; caso contrário, o acesso a m_pstring produzirá resultados não confiáveis.

CDBVariant::m_pstringA

Armazena um ponteiro para um objeto CString ASCII.

Comentários

O membro de dados m_pstringA pertence a uma união. Antes de acessar m_pstringA, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_ASTRING, m_pstringA conterá um ponteiro válido; caso contrário, o acesso a m_pstringA produzirá resultados não confiáveis.

CDBVariant::m_pstringW

Armazena um ponteiro para um objeto CString largo.

Comentários

O membro de dados m_pstringW pertence a uma união. Antes de acessar m_pstringW, verifique o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_WSTRING, m_pstringW conterá um ponteiro válido; caso contrário, o acesso a m_pstringW produzirá resultados não confiáveis.

Confira também

Gráfico da hierarquia
Classe CRecordset