db_source

Bir veri kaynağına bağlantı oluşturur.

Sözdizimi

[ db_source(db_source, name, hresult) ]

Parametreler

db_source
Veri kaynağına bağlanmak için kullanılan bağlantı dizesi. bağlantı dizesi biçimi için bkz. Microsoft Veri Erişim Bileşenleri (MDAC) SDK'sında Bağlantı Dizeleri ve Veri Bağlantıları.

ad
(İsteğe bağlı) Bir sınıfta db_source kullandığınızda ad, db_source özniteliğinin uygulandığı bir veri kaynağı nesnesinin örneğidir (örnek 1'e bakın). Bir yöntem uygulamasında satır içi db_source kullandığınızda, ad veri kaynağına erişmek için kullanılabilecek bir değişkendir (yöntemin yerelidir) (örnek 2'ye bakın). Veri kaynağını bir komutla ilişkilendirmek için bu adı source_name parametresine db_command geçirirsiniz.

hresult
(İsteğe bağlı) Bu veritabanı komutunun HRESULT değerini alacak değişkeni tanımlar. Değişken yoksa, özniteliği tarafından otomatik olarak eklenir.

Açıklamalar

db_source bir OLE DB tüketici veri kaynağıyla bağlantıyı temsil eden bir CDataSource ve CSession nesnesi oluşturur.

Bir sınıfta db_source kullandığınızda, CSession nesnesi sınıfın bir üyesi olur.

Bir yöntemde db_source kullandığınızda, eklenen kod yöntem kapsamında yürütülür ve CSession nesne yerel değişken olarak oluşturulur.

db_source bir sınıfa veya bir yöntem içinde veri kaynağı özellikleri ekler. ile db_command birlikte kullanılır (source_name parametresi olarak db_source ad parametresini alır).

Tüketici öznitelik sağlayıcısı bu özniteliği bir sınıfa uyguladığında, derleyici sınıfı _YourClassNameErişimcisi olarak yeniden adlandırır; burada YourClassName sınıfını vermiş olduğunuz addır ve derleyici de _YourClassNameErişimcisinden türetilen YourClassName adlı bir sınıf oluşturur. Sınıf Görünümü'nde her iki sınıfı da görürsünüz.

Bir uygulamada kullanılan bu özniteliğin bir örneği için bkz . MultiRead.

Örnek

Bu örnek, Northwind veritabanını kullanarak veri kaynağına ds bağlantı oluşturmak için bir sınıftaki db_source çağırır. ds , veri kaynağının sınıfı için dahili olarak kullanılabilecek bir tanıtıcıdır CMyCommand .

// db_source_1.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[
  db_source(L"my_connection_string", name="ds"),
  db_command(L"select * from Products")
]
class CMyCommand {};

Gereksinimler

Öznitelik bağlamı	Değer
Şunlar için geçerlidir:	class, struct, üye, yöntem, yerel
Tekrarlanabilir	Hayır
Gerekli öznitelikler	Hiçbiri
Geçersiz öznitelikler	Hiçbiri

Öznitelik bağlamları hakkında daha fazla bilgi için bkz . Öznitelik Bağlamları.

Ayrıca bkz.

OLE DB Tüketici Öznitelikleri