CDataConnection-Klasse
Verwaltet die Verbindung mit der Datenquelle.
Syntax
class CDataConnection
Anforderungen
Header: atldbcli.h
Member
Methoden
| Name | Beschreibung |
|---|---|
CDataConnection::CDataConnection |
Konstruktor. Instanziiert und initialisiert ein CDataConnection Objekt. |
CDataConnection::Copy |
Erstellt eine Kopie einer vorhandenen Datenverbindung. |
CDataConnection::Open |
Öffnet eine Verbindung mit einer Datenquelle mithilfe einer Initialisierungszeichenfolge. |
CDataConnection::OpenNewSession |
Öffnet eine neue Sitzung für die aktuelle Verbindung. |
Operatoren
| Name | Beschreibung |
|---|---|
CDataConnection::operator BOOL |
Bestimmt, ob die aktuelle Sitzung geöffnet ist oder nicht. |
CDataConnection::operator bool |
Bestimmt, ob die aktuelle Sitzung geöffnet ist oder nicht. |
CDataConnection::operator CDataSource& |
Gibt einen Verweis auf das enthaltene CDataSource Objekt zurück. |
CDataConnection::operator CDataSource* |
Gibt einen Zeiger auf das enthaltene CDataSource Objekt zurück. |
CDataConnection::operator CSession& |
Gibt einen Verweis auf das enthaltene CSession Objekt zurück. |
CDataConnection::operator CSession* |
Gibt einen Zeiger auf das enthaltene CSession Objekt zurück. |
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.
Hinweis
Wenn Sie eine Datenbankanwendung erstellen, die mehrere Sitzungen verarbeiten muss, müssen Sie diese verwenden OpenNewSession.
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.