CDataConnection sınıfı

Veri kaynağıyla bağlantıyı yönetir.

Sözdizimi

class CDataConnection

Gereksinimler

Üst bilgi: atldbcli.h

Üyeler

Yöntemler

Veri Akışı Adı	Açıklama
CDataConnection::CDataConnection	Oluşturucu. Bir CDataConnection nesnenin örneğini oluşturur ve başlatır.
CDataConnection::Copy	Mevcut bir veri bağlantısının kopyasını oluşturur.
CDataConnection::Open	Başlatma dizesi kullanarak bir veri kaynağına bağlantı açar.
CDataConnection::OpenNewSession	Geçerli bağlantıda yeni bir oturum açar.

İşleçler

Veri Akışı Adı	Açıklama
CDataConnection::operator BOOL	Geçerli oturumun açık olup olmadığını belirler.
CDataConnection::operator bool	Geçerli oturumun açık olup olmadığını belirler.
CDataConnection::operator CDataSource&	İçerilen CDataSource nesneye bir başvuru döndürür.
CDataConnection::operator CDataSource*	İçerilen CDataSource nesneye bir işaretçi döndürür.
CDataConnection::operator CSession&	İçerilen CSession nesneye bir başvuru döndürür.
CDataConnection::operator CSession*	İçerilen CSession nesneye bir işaretçi döndürür.

Açıklamalar

CDataConnection , gerekli nesneleri (veri kaynağı ve oturum) ve bir veri kaynağına bağlanırken yapmanız gereken bazı işleri kapsüllediğinden istemci oluşturmak için kullanışlı bir sınıftır

olmadan CDataConnectionbir CDataSource nesne oluşturmanız, yöntemini çağırmanız OpenFromInitializationString , sonra bir CSession nesnenin örneğini oluşturmanız, yöntemini çağırmanız Open , sonra bir CCommand nesne oluşturmanız ve * yöntemlerini çağırmanız Opengerekir.

ile CDataConnectionyalnızca bir bağlantı nesnesi oluşturmanız, bir başlatma dizesi geçirmeniz ve ardından komutları açmak için bu bağlantıyı kullanmanız gerekir. Veritabanı bağlantınızı tekrar tekrar kullanmayı planlıyorsanız, bağlantıyı açık tutmak iyi bir fikirdir ve CDataConnection bunu yapmak için uygun bir yol sağlar.

Not

Birden çok oturumu işlemesi gereken bir veritabanı uygulaması oluşturuyorsanız kullanmanız gerekir OpenNewSession.

CDataConnection::CDataConnection

Bir CDataConnection nesnenin örneğini oluşturur ve başlatır.

Sözdizimi

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

Parametreler

ds
[in] Mevcut bir veri bağlantısına başvuru.

Açıklamalar

İlk geçersiz kılma, varsayılan ayarlarla yeni CDataConnection bir nesne oluşturur.

İkinci geçersiz kılma, belirttiğiniz veri bağlantısı nesnesine eşdeğer ayarlara sahip yeni CDataConnection bir nesne oluşturur.

CDataConnection::Copy

Mevcut bir veri bağlantısının kopyasını oluşturur.

Sözdizimi

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

Parametreler

ds
[in] Kopyalanacak mevcut bir veri bağlantısına başvuru.

CDataConnection::Open

Başlatma dizesi kullanarak bir veri kaynağına bağlantı açar.

Sözdizimi

HRESULT Open(LPCOLESTR szInitString) throw();

Parametreler

szInitString
[in] Veri kaynağının başlatma dizesi.

Dönüş değeri

Standart HRESULTbir .

CDataConnection::OpenNewSession

Geçerli bağlantı nesnesinin veri kaynağını kullanarak yeni bir oturum açar.

Sözdizimi

HRESULT OpenNewSession(CSession & session) throw();

Parametreler

session
[in/out] Yeni oturum nesnesine başvuru.

Açıklamalar

Yeni oturum, geçerli bağlantı nesnesinin içerdiği veri kaynağı nesnesini üst öğesi olarak kullanır ve veri kaynağıyla aynı bilgilerin tümüne erişebilir.

Dönüş değeri

Standart HRESULTbir .

CDataConnection::operator BOOL

Geçerli oturumun açık olup olmadığını belirler.

Sözdizimi

operator BOOL() throw();

Açıklamalar

(MFC typedef) değerini döndürür BOOL . TRUE geçerli oturumun açık olduğu anlamına gelir; FALSE geçerli oturumun kapalı olduğu anlamına gelir.

CDataConnection::operator bool (OLE DB)

Geçerli oturumun açık olup olmadığını belirler.

Sözdizimi

operator bool() throw();

Açıklamalar

bool Bir (C++ veri türü) değeri döndürür. true geçerli oturumun açık olduğu anlamına gelir; false geçerli oturumun kapalı olduğu anlamına gelir.

CDataConnection::operator CDataSource&

İçerilen CDataSource nesneye bir başvuru döndürür.

Sözdizimi

operator const CDataSource&() throw();

Açıklamalar

Bu işleç, içerdiği CDataSource nesneye başvuru döndürerek başvurunun beklendiği bir CDataConnection CDataSource nesneyi geçirmenizi sağlar.

Örnek

Başvuru alan CDataSource bir işleviniz (örneğinfunc, aşağıda) varsa, bunu kullanarak bunun yerine bir CDataConnection nesne geçirebilirsinizCDataSource&.

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

 

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

CDataConnection::operator CDataSource*

İçerilen CDataSource nesneye bir işaretçi döndürür.

Sözdizimi

operator const CDataSource*() throw();

Açıklamalar

Bu işleç, içerdiği CDataSource nesneye bir işaretçi döndürerek işaretçinin beklendiği bir CDataSource nesneyi geçirmenize CDataConnection olanak sağlar.

Kullanım örneği için bkz operator CDataSource& .

CDataConnection::operator CSession&

İçerilen CSession nesneye bir başvuru döndürür.

Sözdizimi

operator const CSession&();

Açıklamalar

Bu işleç, içerdiği CSession nesneye başvuru döndürerek başvurunun beklendiği bir CDataConnection CSession nesneyi geçirmenizi sağlar.

Örnek

Başvuru alan CSession bir işleviniz (örneğinfunc, aşağıda) varsa, bunu kullanarak bunun yerine bir CDataConnection nesne geçirebilirsinizCSession&.

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*

İçerilen CSession nesneye bir işaretçi döndürür.

Sözdizimi

operator const CSession*() throw();

Açıklamalar

Bu işleç, içerdiği CSession nesneye bir işaretçi döndürerek işaretçinin beklendiği bir CSession nesneyi geçirmenize CDataConnection olanak sağlar.

Örnek

Kullanım örneği için bkz operator CSession& .

Ayrıca bkz.

OLE DB tüketici şablonları
OLE DB tüketici şablonları başvurusu