Freigeben über

CDBPropSet-Klasse

  • Artikel

Erbt von der DBPROPSET Struktur und fügt einen Konstruktor hinzu, der Schlüsselfelder sowie die AddProperty Access-Methode initialisiert.

Syntax

class CDBPropSet : public tagDBPROPSET

Anforderungen

Header: atldbcli.h

Member

Methoden

Name Beschreibung
AddProperty Fügt dem Eigenschaftensatz eine Eigenschaft hinzu.
CDBPropSet Konstruktor.
SetGUID Legt das guidPropertySet Feld der DBPROPSET Struktur fest.

Operatoren

Name Beschreibung
operator = Weist den Inhalt einer Eigenschaft zu, die auf eine andere festgelegt ist.

Hinweise

OLE DB-Anbieter und Consumer verwenden DBPROPSET Strukturen, um Arrays von DBPROP Strukturen zu übergeben. Jede DBPROP Struktur stellt eine einzelne Eigenschaft dar, die festgelegt werden kann.

CDBPropSet::AddProperty

Fügt dem Eigenschaftensatz eine Eigenschaft hinzu.

Syntax

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();

Parameter

dwPropertyID
[in] Die ID der hinzuzufügenden Eigenschaft. Wird verwendet, um die dwPropertyID Struktur zu initialisieren, die DBPROP dem Eigenschaftensatz hinzugefügt wurde.

var
[in] Eine Variante, die verwendet wird, um den Eigenschaftswert für die Struktur zu initialisieren, die DBPROP dem Eigenschaftensatz hinzugefügt wurde.

szValue
[in] Eine Zeichenfolge, die verwendet wird, um den Eigenschaftswert für die Struktur zu initialisieren, die DBPROP dem Eigenschaftensatz hinzugefügt wurde.

bValue
[in] Ein BYTE boolescher Wert, der zum Initialisieren des Eigenschaftswerts für die Struktur verwendet wird, die DBPROP dem Eigenschaftensatz hinzugefügt wurde.

nValue
[in] Ein ganzzahliger Wert, der zum Initialisieren des Eigenschaftswerts für die Struktur verwendet wird, die DBPROP dem Eigenschaftensatz hinzugefügt wurde.

fltValue
[in] Ein Gleitkommawert, der zum Initialisieren des Eigenschaftswerts für die DBPROP Struktur verwendet wird, die dem Eigenschaftensatz hinzugefügt wurde.

dblValue
[in] Ein Gleitkommawert mit doppelter Genauigkeit, der zum Initialisieren des Eigenschaftswerts für die Struktur verwendet wird, die DBPROP dem Eigenschaftensatz hinzugefügt wurde.

cyValue
[in] Ein CY-Währungswert, der zum Initialisieren des Eigenschaftswerts für die DBPROP Struktur verwendet wird, die dem Eigenschaftensatz hinzugefügt wurde.

Rückgabewert

true wenn die Eigenschaft erfolgreich hinzugefügt wurde. Andernfalls false.

CDBPropSet::CDBPropSet

Der Konstruktor. Initialisiert die rgPropertiesFelder cPropertiesund guidPropertySet Felder der DBPROPSET-Struktur .

Syntax

CDBPropSet(const GUID& guid);

CDBPropSet(const CDBPropSet& propset);

CDBPropSet();

Parameter

guid
[in] Eine GUID, die zum Initialisieren des guidPropertySet Felds verwendet wird.

Propset
[in] Ein weiteres CDBPropSet Objekt für die Kopierkonstruktion.

CDBPropSet::SetGUID

Legt das guidPropertySet Feld in der DBPROPSET Struktur fest.

Syntax

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

Parameter

guid
[in] Eine GUID, die zum Festlegen des guidPropertySet Felds der DBPROPSET-Struktur verwendet wird.

Hinweise

Dieses Feld kann auch vom Konstruktor festgelegt werden.

CDBPropSet::operator =

Weist den Inhalt einer Eigenschaft, die einem anderen Eigenschaftensatz zugewiesen ist, zu.

Syntax

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

Siehe auch

OLE DB-Consumervorlagen
Referenz der OLE DB-Consumervorlagen
CDBPropIDSet-Klasse
DBPROPSET-Struktur DBPROP-Struktur