CDataConnection-Klasse

Verwaltet die Verbindung mit der Datenquelle.

Syntax

class CDataConnection

Anforderungen

Header: atldbcli.h

Member

Methoden

Operatoren

Hinweise

CDataConnection ist eine nützliche Klasse zum Erstellen von Clients, da sie die erforderlichen Objekte (Datenquelle und Sitzung) und einige der erforderlichen Aufgaben beim Herstellen einer Verbindung mit einer Datenquelle kapselt.

Ohne CDataConnection, müssen Sie ein CDataSource Objekt erstellen, seine OpenFromInitializationString Methode aufrufen, dann eine Instanz eines CSession Objekts erstellen, seine Open Methode aufrufen, dann ein CCommand Objekt erstellen und seine Open* -Methoden aufrufen.

Mit CDataConnection, müssen Sie nur ein Verbindungsobjekt erstellen, es eine Initialisierungszeichenfolge übergeben und dann diese Verbindung zum Öffnen von Befehlen verwenden. Wenn Sie ihre Verbindung mit der Datenbank wiederholt verwenden möchten, empfiehlt es sich, die Verbindung offen zu halten und CDataConnection eine bequeme Möglichkeit zu bieten.

CDataConnection::CDataConnection

Instanziiert und initialisiert ein CDataConnection Objekt.

Syntax

CDataConnection();
CDataConnection(const CDataConnection &ds);

Parameter

ds
[in] Ein Verweis auf eine vorhandene Datenverbindung.

Hinweise

Die erste Außerkraftsetzung erstellt ein neues CDataConnection Objekt mit Standardeinstellungen.

Die zweite Außerkraftsetzung erstellt ein neues CDataConnection Objekt mit Einstellungen, die dem von Ihnen angegebenen Datenverbindungsobjekt entsprechen.

CDataConnection::Copy

Erstellt eine Kopie einer vorhandenen Datenverbindung.

Syntax

CDataConnection& Copy(const CDataConnection & ds) throw();

Parameter

ds
[in] Ein Verweis auf eine vorhandene Zu kopierende Datenverbindung.

CDataConnection::Open

Öffnet eine Verbindung mit einer Datenquelle mithilfe einer Initialisierungszeichenfolge.

Syntax

HRESULT Open(LPCOLESTR szInitString) throw();

Parameter

szInitString
[in] Die Initialisierungszeichenfolge für die Datenquelle.

Rückgabewert

Ein Standard HRESULT.

CDataConnection::OpenNewSession

Öffnet eine neue Sitzung mit der Datenquelle des aktuellen Verbindungsobjekts.

Syntax

HRESULT OpenNewSession(CSession & session) throw();

Parameter

session
[in/out] Ein Verweis auf das neue Sitzungsobjekt.

Hinweise

Die neue Sitzung verwendet das enthaltene Datenquellenobjekt des aktuellen Verbindungsobjekts als übergeordnetes Objekt und kann auf alle gleichen Informationen wie die Datenquelle zugreifen.

Rückgabewert

Ein Standard HRESULT.

CDataConnection::operator BOOL

Bestimmt, ob die aktuelle Sitzung geöffnet ist oder nicht.

Syntax

operator BOOL() throw();

Hinweise

Gibt den BOOL Wert (MFC typedef) zurück. TRUE bedeutet, dass die aktuelle Sitzung geöffnet ist; FALSE bedeutet, dass die aktuelle Sitzung geschlossen ist.

CDataConnection::operator bool (OLE DB)

Bestimmt, ob die aktuelle Sitzung geöffnet ist oder nicht.

Syntax

operator bool() throw();

Hinweise

Gibt einen bool (C++-Datentyp) Wert zurück. true bedeutet, dass die aktuelle Sitzung geöffnet ist; false bedeutet, dass die aktuelle Sitzung geschlossen ist.

CDataConnection::operator CDataSource&

Gibt einen Verweis auf das enthaltene CDataSource Objekt zurück.

Syntax

operator const CDataSource&() throw();

Hinweise

Dieser Operator gibt einen Verweis auf das enthaltene CDataSource Objekt zurück, sodass Sie ein CDataConnection Objekt übergeben können, bei dem ein CDataSource Verweis erwartet wird.

Beispiel

Wenn Sie über eine Funktion (z func . B. unten) verfügen, die einen CDataSource Verweis verwendet, können CDataSource& Sie stattdessen ein CDataConnection Objekt übergeben.

void SourceFunc(const CDataSource& theSource)
{
   CComVariant var;
   theSource.GetProperty(DBPROPSET_DATASOURCEINFO, DBPROP_DATASOURCENAME, &var);
}

CDataConnection dc;
dc.Open(szInit);
SourceFunc(dc);

CDataConnection::operator CDataSource*

Gibt einen Zeiger auf das enthaltene CDataSource Objekt zurück.

Syntax

operator const CDataSource*() throw();

Hinweise

Dieser Operator gibt einen Zeiger auf das enthaltene CDataSource Objekt zurück, sodass Sie ein CDataConnection Objekt übergeben können, bei dem ein CDataSource Zeiger erwartet wird.

Ein Verwendungsbeispiel finden Sie unter.See operator CDataSource& for a usage example.

CDataConnection::operator CSession&

Gibt einen Verweis auf das enthaltene CSession Objekt zurück.

Syntax

operator const CSession&();

Hinweise

Dieser Operator gibt einen Verweis auf das enthaltene CSession Objekt zurück, sodass Sie ein CDataConnection Objekt übergeben können, bei dem ein CSession Verweis erwartet wird.

Beispiel

Wenn Sie über eine Funktion (z func . B. unten) verfügen, die einen CSession Verweis verwendet, können CSession& Sie stattdessen ein CDataConnection Objekt übergeben.

void SessionFunc(const CSession& theSession)
{
   XACTTRANSINFO info = {0};
   HRESULT hr = theSession.GetTransactionInfo(&info);
   wprintf_s(_T("GetTransactionInfo returned %x\n"), hr);
}

CDataConnection dc;
dc.Open(szInit);
SessionFunc(dc);

CDataConnection::operator CSession*

Gibt einen Zeiger auf das enthaltene CSession Objekt zurück.

Syntax

operator const CSession*() throw();

Hinweise

Dieser Operator gibt einen Zeiger auf das enthaltene CSession Objekt zurück, sodass Sie ein CDataConnection Objekt übergeben können, bei dem ein CSession Zeiger erwartet wird.

Beispiel

Ein Verwendungsbeispiel finden Sie unter.See operator CSession& for a usage example.

Siehe auch

OLE DB-Consumervorlagen
OLE DB-Consumervorlagenreferenz