CDataSource Sınıfı

Bir sağlayıcıdan veri kaynağına bağlantıyı temsil eden bir OLE DB veri kaynağı nesnesine karşılık gelir.

Sözdizimi

class CDataSource

Gereksinimler

Üst bilgi: atldbcli.h

Üyeler

Yöntemler

Veri Akışı Adı	Açıklama
Kapat	Bağlantıyı kapatır.
GetInitializationString	Şu anda açık olan veri kaynağının başlatma dizesini alır.
GetProperties	Bağlı veri kaynağı için ayarlanmış olan özelliklerin değerlerini alır.
GetProperty	Bağlı veri kaynağı için ayarlanmış tek bir özelliğin değerini alır.
Aç	Çağıran tarafından sağlanan bir , CLSIDveya bir takma ad kullanarak ProgIDbir CEnumerator sağlayıcıya (veri kaynağı) bağlantı oluşturur.
OpenFromFileName	Kullanıcı tarafından sağlanan dosya adı tarafından belirtilen bir dosyadan veri kaynağı açar.
OpenFromInitializationString	Başlatma dizesi tarafından belirtilen veri kaynağını açar.
OpenWithPromptFileName	Kullanıcının daha önce oluşturulmuş bir veri bağlantısı dosyasını seçerek ilgili veri kaynağını açmasına izin verir.
OpenWithServiceComponents	Veri Bağlantısı iletişim kutusunu kullanarak bir veri kaynağı nesnesi açar.

Açıklamalar

Tek bir bağlantı için bir veya daha fazla veritabanı oturumu oluşturulabilir. Bu oturumlar ile CSessiontemsil edilir. ile oturum oluşturmadan önce bağlantıyı açmak için CDataSource::Open'ıCSession::Open.

nasıl kullanılacağına CDataSourceilişkin bir örnek için bkz . CatDB örneği.

CDataSource::Close

İşaretçiyi serbest bırakarak m_spInit bağlantıyı kapatır.

Sözdizimi

void Close() throw();

CDataSource::GetInitializationString

Şu anda açık olan bir veri kaynağının başlatma dizesini alır.

Sözdizimi

HRESULT GetInitializationString(BSTR* pInitializationString,
   bool bIncludePassword = false) throw();

Parametreler

pInitializationString
[out] Başlatma dizesinin işaretçisi.

bIncludePassword
[in] true dize bir parola içeriyorsa; aksi takdirde false.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Sonuçta elde edilen başlatma dizesi daha sonra bu veri kaynağı bağlantısını yeniden açmak için kullanılabilir.

CDataSource::GetProperties

Bağlı veri kaynağı nesnesi için istenen özellik bilgilerini döndürür.

Sözdizimi

HRESULT GetProperties(ULONG ulPropIDSets,
   constDBPROPIDSET* pPropIDSet,
   ULONG* pulPropertySets,
   DBPROPSET** ppPropsets) const throw();

Parametreler

Windows SDK'sında OLE DB Programcı Başvurusu'ndaki IDBProperties::GetProperties bölümüne bakın.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Tek bir özellik almak için GetProperty kullanın.

CDataSource::GetProperty

Bağlı veri kaynağı nesnesi için belirtilen özelliğin değerini döndürür.

Sözdizimi

HRESULT GetProperty(const GUID& guid,
   DBPROPID propid,
   VARIANT* pVariant) const throw();

Parametreler

Guıd
[in] Özelliğinin döndürüleceği özellik kümesini tanımlayan GUID.

propid
[in] Döndürülecek özelliğin özellik kimliği.

pVariant
[out] Özelliğin değerini döndüren GetProperty değişken işaretçisi.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Birden çok özellik almak için GetProperties kullanın.

CDataSource::Open

, CLSIDveya takma adı kullanarak ProgIDbir veri kaynağına bağlantı açar veya CEnumerator kullanıcıya bir bulucu iletişim kutusu sorar.

Sözdizimi

HRESULT Open(const CLSID& clsid,
   DBPROPSET* pPropSet = NULL,
   ULONG nPropertySets = 1) throw();

HRESULT Open(const CLSID& clsid,
   LPCTSTR pName,
   LPCTSTR pUserName = NULL,
   LPCTSTR pPassword = NULL,
   long nInitMode = 0) throw();HRESULT Open(LPCTSTR szProgID,
   DBPROPSET* pPropSet = NULL,
   ULONG nPropertySets = 1) throw();HRESULT Open(LPCTSTR szProgID,
   LPCTSTR pName,  LPCTSTR pUserName = NULL,
   LPCTSTR pPassword = NULL,
   long nInitMode = 0) throw();

HRESULT Open(const CEnumerator& enumerator,
   DBPROPSET* pPropSet = NULL,
   ULONG nPropertySets = 1) throw();

HRESULT Open(const CEnumerator& enumerator,
   LPCTSTR pName,
   LPCTSTR pUserName = NULL,
   LPCTSTR pPassword = NULL,
   long nInitMode = 0) throw();

HRESULT Open(HWND hWnd = GetActiveWindow(),
   DBPROMPTOPTIONS dwPromptOptions = DBPROMPTOPTIONS_WIZARDSHEET) throw();

HRESULT Open(LPCWSTR szProgID,
   DBPROPSET* pPropSet = NULL,
   ULONG nPropertySets = 1) throw();

HRESULT Open(LPCSTR szProgID,
   LPCTSTR pName,LPCTSTR pUserName = NULL,
   LPCTSTR pPassword = NULL,
   long nInitMode = 0) throw();

Parametreler

clsid
[in] CLSID Veri sağlayıcısının.

pPropSet
[in] Ayarlanacak özellikleri ve değerleri içeren DBPROPSET yapıları dizisinin işaretçisi. Bkz. Windows SDK'sında OLE DB Programcı Başvurusu'ndaki Özellik Kümeleri ve Özellik Grupları.

nPropertySets
[in] pPropSet bağımsız değişkeninde geçirilen DBPROPSET yapılarının sayısı.

pName
[in] Bağlanacak veritabanının adı.

pUserName
[in] Kullanıcının adı.

pPassword
[in] Kullanıcının parolası.

nInitMode
[in] Veritabanı başlatma modu. Geçerli başlatma modlarının listesi için bkz. Windows SDK'sında OLE DB Programcı Başvurusu'ndaki Başlatma Özellikleri. nInitMode sıfırsa, bağlantıyı açmak için kullanılan özellik kümesine başlatma modu dahil değildir.

szProgID
[in] Program tanımlayıcısı.

Numaralayıcı
[in] CLSID nesnesi.

hWnd
[in] İletişim kutusunun üst öğesi olacak pencerenin tutamacı. hWnd parametresini kullanan işlev aşırı yüklemesi kullanıldığında Hizmet Bileşenleri otomatik olarak çağrılır; ayrıntılar için açıklamalar bölümüne bakın.

dwPromptOptions
[in] Görüntülenecek bulucu iletişim kutusunun stilini belirler. Olası değerler için bkz. Msdasc.h.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

hWnd parametresini kullanan yöntem aşırı yüklemesi, oledb32.dll'da hizmet bileşenleriyle bir veri kaynağı nesnesi açar; bu DLL, Kaynak Havuzu Oluşturma, Otomatik İşlem Listesi gibi Hizmet Bileşenleri özelliklerinin uygulanmasını içerir. Daha fazla bilgi için OLE DB Programcı Kılavuzu'ndaki OLE DB başvurusuna bakın.

hWnd parametresini kullanmayan yöntem aşırı yüklemeleri, oledb32.dll hizmet bileşenlerini kullanmadan bir veri kaynağı nesnesi açar. Bu işlev aşırı yüklemeleriyle açılan bir CDataSource nesnesi, Hizmet Bileşenlerinin işlevlerinin hiçbirini kullanamayacaktır.

Örnek

Aşağıdaki kodda, OLE DB Şablonları ile Jet 4.0 veri kaynağının nasıl açılası gösterilmektedir. Jet veri kaynağını bir OLE DB veri kaynağı olarak ele alırsınız. Ancak çağrısı iki özellik kümesine Open ihtiyaç duyar: biri DBPROPSET_DBINIT için, diğeri DBPROPSET_JETOLEDB_DBINIT için, böylece DBPROP_JETOLEDB_DATABASEPASSWORD ayarlayabilirsiniz.

CDBPropSet rgDBPropSet[2];  // Declare two property sets;
                            // set properties elsewhere as appropriate.

hr = m_DataSource.Open(szProgId, rgDBPropSet, 2);

CDataSource::OpenFromFileName

Kullanıcı tarafından sağlanan dosya adı tarafından belirtilen bir dosyadan veri kaynağı açar.

Sözdizimi

HRESULT OpenFromFileName(LPCOLESTR szFileName) throw();

Parametreler

szFileName
[in] Bir dosyanın adı, genellikle veri kaynağı bağlantısı (. UDL) dosyası.

Veri bağlantısı dosyaları (.udl dosyaları) hakkında daha fazla bilgi için bkz . Windows SDK'sında Veri Bağlantısı API'sine Genel Bakış .

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, oledb32.dll hizmet bileşenlerini kullanarak bir veri kaynağı nesnesi açar; bu DLL, Kaynak Havuzu, Otomatik İşlem Listesi vb. gibi Hizmet Bileşenleri özelliklerinin uygulanmasını içerir. Daha fazla bilgi için OLE DB Programcı Kılavuzu'ndaki OLE DB başvurusuna bakın.

CDataSource::OpenFromInitializationString

Kullanıcı tarafından sağlanan başlatma dizesi tarafından belirtilen bir veri kaynağını açar.

Sözdizimi

HRESULT OpenFromInitializationString(LPCOLESTR szInitializationString,
   bool fPromptForInfo= false) throw();

Parametreler

szInitializationString
[in] Başlatma dizesi.

fPromptForInfo
[in] Bu bağımsız değişken olarak trueOpenFromInitializationString ayarlanırsa, DBPROP_INIT_PROMPT özelliğini DBPROMPT_COMPLETEREQUIRED olarak ayarlar ve kullanıcıdan yalnızca daha fazla bilgi gerektiğinde isteneceğini belirtir. Bu, başlatma dizesinin parola gerektiren bir veritabanı belirttiği ancak dizenin parolayı içermediği durumlar için kullanışlıdır. Veritabanına bağlanmaya çalışırken kullanıcıdan parola (veya diğer eksik bilgiler) istenir.

Varsayılan değer, kullanıcıdan hiçbir zaman istenmeyeceğini belirten değeridir false(DBPROP_INIT_PROMPT DBPROMPT_NOPROMPT olarak ayarlar).

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, oledb32.dll hizmet bileşenlerini kullanarak bir veri kaynağı nesnesi açar; bu DLL, Kaynak Havuzu, Otomatik İşlem Listesi vb. gibi Hizmet Bileşenleri özelliklerinin uygulanmasını içerir.

CDataSource::OpenWithPromptFileName

Bu yöntem kullanıcıdan bir iletişim kutusu ister, ardından kullanıcı tarafından belirtilen dosyayı kullanarak bir veri kaynağı açar.

Sözdizimi

HRESULT OpenWithPromptFileName(HWND hWnd = GetActiveWindow(   ),
   DBPROMPTOPTIONS dwPromptOptions = DBPROMPTOPTIONS_NONE,
   LPCOLESTR szInitialDirectory = NULL) throw();

Parametreler

hWnd
[in] İletişim kutusunun üst öğesi olacak pencerenin tutamacı.

dwPromptOptions
[in] Görüntülenecek bulucu iletişim kutusunun stilini belirler. Olası değerler için bkz. Msdasc.h.

szInitialDirectory
[in] Bulucu iletişim kutusunda görüntülenecek ilk dizin.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, oledb32.dll hizmet bileşenlerini kullanarak bir veri kaynağı nesnesi açar; bu DLL, Kaynak Havuzu, Otomatik İşlem Listesi vb. gibi Hizmet Bileşenleri özelliklerinin uygulanmasını içerir. Daha fazla bilgi için OLE DB Programcı Kılavuzu'ndaki OLE DB başvurusuna bakın.

CDataSource::OpenWithServiceComponents

oledb32.dll hizmet bileşenlerini kullanarak bir veri kaynağı nesnesi açar.

Sözdizimi

HRESULT OpenWithServiceComponents (const CLSID clsid,
   DBPROPSET* pPropset = NULL,
   ULONG ulPropSets = 1);

HRESULT OpenWithServiceComponents (LPCSTR szProgID,
   DBPROPSET* pPropset = NULL,
   ULONG ulPropSets = 1);

Parametreler

clsid
[in] Veri CLSID sağlayıcısının.

szProgID
[in] Veri sağlayıcısının program kimliği.

pPropset
[in] Ayarlanacak özellikleri ve değerleri içeren DBPROPSET yapıları dizisinin işaretçisi. Bkz. Windows SDK'sında OLE DB Programcı Başvurusu'ndaki Özellik Kümeleri ve Özellik Grupları. Veri kaynağı nesnesi başlatılırsa, özelliklerin Veri Kaynağı özellik grubuna ait olması gerekir. pPropset'te aynı özellik birden çok kez belirtilirse, kullanılan değer sağlayıcıya özgüdür. ulPropSets sıfırsa, bu parametre yoksayılır.

ulPropSets
[in] pPropSet bağımsız değişkeninde geçirilen DBPROPSET yapılarının sayısı. Bu sıfırsa, sağlayıcı pPropset'i yoksayar.

Dönüş Değeri

Standart bir HRESULT.

Açıklamalar

Bu yöntem, oledb32.dll hizmet bileşenlerini kullanarak bir veri kaynağı nesnesi açar; bu DLL, Kaynak Havuzu, Otomatik İşlem Listesi vb. gibi Hizmet Bileşenleri özelliklerinin uygulanmasını içerir. Daha fazla bilgi için OLE DB Programcı Kılavuzu'ndaki OLE DB başvurusuna bakın.

Ayrıca bkz.

OLE DB Tüketici Şablonları
OLE DB Tüketici Şablonları Başvurusu