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ı.