Compartilhar via

Classe CDBPropSet

  • Artigo

Herda da estrutura DBPROPSET e adiciona um construtor que inicializa campos de chave, bem como o método de acesso AddProperty.

Sintaxe

class CDBPropSet : public tagDBPROPSET

Requisitos

Cabeçalho: atldbcli.h

Membros

Métodos

Nome Descrição
AddProperty Adiciona uma propriedade ao conjunto de propriedades.
CDBPropSet Construtor.
SetGUID Define o campo guidPropertySet da estrutura DBPROPSET.

Operadores

Nome Descrição
operador = Atribui o conteúdo de um conjunto de propriedades para outro.

Comentários

Os provedores e consumidores OLE DB usam estruturas DBPROPSET para passar matrizes de estruturas DBPROP. Cada estrutura DBPROP representa uma única propriedade que pode ser definida.

CDBPropSet::AddProperty

Adiciona uma propriedade ao conjunto de propriedades.

Sintaxe

bool AddProperty(DWORD dwPropertyID,
   constVARIANT& var,
   DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED) throw();bool AddProperty(DWORD dwPropertyID,
   LPCSTR szValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED) throw();bool AddProperty(DWORD dwPropertyID,
   LPCWSTR szValue,DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED) throw();bool AddProperty(DWORD dwPropertyID,
   bool bValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED) throw();bool AddProperty(DWORD dwPropertyID,
   BYTE bValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED);bool AddProperty(DWORD dwPropertyID,
   short nValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED);bool AddProperty(DWORD dwPropertyID,
   long nValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED);bool AddProperty(DWORD dwPropertyID,
   float fltValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED);bool AddProperty(DWORD dwPropertyID,
   double dblValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED) throw();bool AddProperty(DWORD dwPropertyID,
   CY cyValue,  DBPROPOPTIONS propoptions = DBPROPOPTIONS_REQUIRED) throw();

Parâmetros

dwPropertyID
[in] A ID da propriedade a ser adicionada. Usada para inicializar a dwPropertyID da estrutura DBPROP adicionada ao conjunto de propriedades.

var
[in] Uma variante usada para inicializar o valor da propriedade para a estrutura DBPROP adicionada ao conjunto de propriedades.

szValue
[in] Uma cadeia de caracteres usada para inicializar o valor da propriedade para a estrutura DBPROP adicionada ao conjunto de propriedades.

bValue
[in] Um valor BYTE ou booliano usado para inicializar o valor da propriedade para a DBPROP estrutura adicionada ao conjunto de propriedades.

nValue
[in] Um valor inteiro usado para inicializar o valor da propriedade para a estrutura DBPROP adicionada ao conjunto de propriedades.

fltValue
[in] Um valor de ponto flutuante usado para inicializar o valor da propriedade para a estrutura DBPROP adicionada ao conjunto de propriedades.

dblValue
[in] Um valor de ponto flutuante de precisão dupla usado para inicializar o valor da propriedade para a estrutura DBPROP adicionada ao conjunto de propriedades.

cyValue
[in] Um valor de moeda CY usado para inicializar o valor da propriedade para a estrutura DBPROP adicionada ao conjunto de propriedades.

Valor de retorno

true se a propriedade foi adicionada com êxito. Caso contrário, false.

CDBPropSet::CDBPropSet

O construtor . Inicializa os campos rgProperties, cProperties e guidPropertySet da estrutura DBPROPSET.

Sintaxe

CDBPropSet(const GUID& guid);

CDBPropSet(const CDBPropSet& propset);

CDBPropSet();

Parâmetros

guid
[in] Um GUID usado para inicializar o campo guidPropertySet.

propset
[entrada] Outro objeto CDBPropSet para a construção de cópia.

CDBPropSet::SetGUID

Define o campo guidPropertySet na estrutura DBPROPSET.

Sintaxe

void SetGUID(const GUID& guid) throw();

Parâmetros

guid
[in] Um GUID usado para definir o campo guidPropertySet da estrutura DBPROPIDSET.

Comentários

Esse campo também pode ser definido pelo construtor.

CDBPropSet::operator =

Atribui o conteúdo de um conjunto de propriedades a outro conjunto de propriedades.

Sintaxe

CDBPropSet& operator =(CDBPropSet& propset) throw();

Confira também

Modelos de consumidor OLE DB
Referência de modelos de consumidor do OLE DB
Classe CDBPropIDSet
DBPROPSET StructureDBPROP Structure