Classe CDBVariant

Representa um tipo de dado variante para as classes ODBC MFC.

Sintaxe

class CDBVariant

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Membros do Sindicato Público

Observações

CDBVariant não tem uma classe base.

CDBVariant é semelhante ao COleVariant; no entanto, CDBVariant não utiliza OLE. CDBVariant Permite-lhe armazenar um valor sem se preocupar com o tipo de dado do valor. CDBVariant acompanha o tipo de dado do valor atual, que é armazenado numa união.

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

Hierarquia de herança

CDBVariant

Requerimentos

Cabeçalho: afxdb.h

CDBVariant::CDBVariant

Cria um objeto NULL CDBVariant .

CDBVariant();

Observações

Define o m_dwType membro de dados para DBVT_NULL.

CDBVariant::Limpo

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

void Clear();

Observações

Se o valor do m_dwType membro de dados for DBVT_DATE, DBVT_STRING ou DBVT_BINARY, Clear liberta-se a memória associada ao membro do ponteiro union. Clear define m_dwType para DBVT_NULL.

O CDBVariant destruidor chama Clear.

CDBVariant::m_boolVal

Armazena um valor do tipo BOOL.

Observações

O m_boolVal membro de dados pertence a um sindicato. Antes de aceder m_boolVala , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido para DBVT_BOOL, então m_boolVal conterá um valor válido; caso contrário, aceder m_boolVal produzirá resultados pouco fiáveis.

CDBVariant::m_chVal

Armazena um valor do tipo unsigned char.

Observações

O m_chVal membro de dados pertence a um sindicato. Antes de aceder m_chVala , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido como DBVT_UCHAR, então m_chVal contém um valor válido; caso contrário, aceder m_chVal produzirá resultados pouco fiáveis.

CDBVariant::m_dblVal

Armazena um valor do tipo double.

Observações

O m_dblVal membro de dados pertence a um sindicato. Antes de aceder m_dblVala , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido para DBVT_DOUBLE, então m_dblVal contém um valor válido; caso contrário, aceder m_dblVal produzirá resultados pouco fiáveis.

CDBVariant::m_dwType

Este membro de dados contém o tipo de dado do valor que está atualmente armazenado no CDBVariant membro de dados union do objeto.

Observações

Antes de aceder a este sindicato, deve verificar o valor de m_dwType para determinar a que membro de dados do sindicato deve aceder. A tabela seguinte lista os valores possíveis para m_dwType e para o correspondente membro de dados da união.

CDBVariant::m_fltVal

Armazena um valor do tipo float.

Observações

O m_fltVal membro de dados pertence a um sindicato. Antes de aceder m_fltVala , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType estiver definido como DBVT_SINGLE, então m_fltVal contém um valor válido; caso contrário, aceder m_fltVal produzirá resultados pouco fiáveis.

CDBVariant::m_iVal

Armazena um valor do tipo short.

Observações

O m_iVal membro de dados pertence a um sindicato. Antes de aceder m_iVala , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido para DBVT_SHORT, então m_iVal contém um valor válido; caso contrário, aceder m_iVal produzirá resultados pouco fiáveis.

CDBVariant::m_lVal

Armazena um valor do tipo long.

Observações

O m_lVal membro de dados pertence a um sindicato. Antes de aceder m_lVala , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido para DBVT_LONG, então m_lVal contém um valor válido; caso contrário, aceder m_lVal produzirá resultados pouco fiáveis.

CDBVariant::m_pbinary

Armazena um ponteiro para um objeto do tipo CLongBinary.

Observações

O m_pbinary membro de dados pertence a um sindicato. Antes de aceder m_pbinarya , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido para DBVT_BINARY, então m_pbinary contém um ponteiro válido; caso contrário, aceder m_pbinary produzirá resultados pouco fiáveis.

CDBVariant::m_pdate

Armazena um ponteiro para um objeto do tipo TIMESTAMP_STRUCT.

Observações

O m_pdate membro de dados pertence a um sindicato. Antes de aceder m_pdatea , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType estiver definido para DBVT_DATE, então m_pdate contém um ponteiro válido; caso contrário, o acesso m_pdate produzirá resultados pouco fiáveis.

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

CDBVariant::m_pstring

Armazena um ponteiro para um objeto do tipo CString.

Observações

O m_pstring membro de dados pertence a um sindicato. Antes de aceder m_pstringa , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType estiver definido para DBVT_STRING, então m_pstring contém um ponteiro válido; caso contrário, aceder m_pstring produzirá resultados pouco fiáveis.

CDBVariant::m_pstringA

Armazena um ponteiro para um objeto CString ASCII.

Observações

O m_pstringA membro de dados pertence a um sindicato. Antes de aceder m_pstringAa , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType for definido para DBVT_ASTRING, então m_pstringA contém um ponteiro válido; caso contrário, aceder m_pstringA produzirá resultados pouco fiáveis.

CDBVariant::m_pstringW

Armazena um ponteiro para um objeto CString largo.

Observações

O m_pstringW membro de dados pertence a um sindicato. Antes de aceder m_pstringWa , verifique primeiro o valor de CDBVariant::m_dwType. Se m_dwType estiver definido para DBVT_WSTRING, então m_pstringW contém um ponteiro válido; caso contrário, aceder m_pstringW produzirá resultados pouco fiáveis.

Consulte também

Gráfico de Hierarquia
Classe CRecordset