db_column

Belirtilen sütunu satır kümesindeki bir değişkene bağlar.

Sözdizimi

[ db_column(ordinal, dbtype, precision, scale, status, length) ]

Parametreler

Sıralı
Verilerin bağlandığı satır kümesindeki bir alana karşılık gelen sıralı sütun numarası (DBCOLUMNINFO sıralı) veya sütun adı (ANSI veya Unicode dizesi). Sayı kullanıyorsanız ardışık sıraları atlayabilirsiniz (örneğin: 1, 2, 3, 5). Kullandığınız OLE DB sağlayıcısı destekliyorsa ad boşluk içerebilir. Örneğin, aşağıdaki biçimlerden birini kullanabilirsiniz:

[db_column("2")] TCHAR szCity[30];
[db_column(L"city_name")] TCHAR szCity[30];

dbtype
(İsteğe bağlı) Sütun girişi için bir OLE DB Tür Göstergesi .

kesinlik
(İsteğe bağlı) Sütun girişi için kullanılacak duyarlık. Ayrıntılar için DBBINDING yapısının bPrecision öğesinin açıklamasına bakın

ölçeklemek
(İsteğe bağlı) Sütun girişi için kullanılacak ölçek. Ayrıntılar için DBBINDING yapısının öğesinin açıklamasına bScale bakın

durum
(İsteğe bağlı) Bu sütunun durumunu tutmak için kullanılan üye değişkeni. Durum, sütun değerinin bir veri değeri mi yoksa NULL gibi başka bir değer mi olduğunu gösterir. Olası değerler için OLE DB Programcı Başvurusu'nda Durum bölümüne bakın.

length
(İsteğe bağlı) Sütunun boyutunu bayt cinsinden tutmak için kullanılan üye değişkeni.

Açıklamalar

db_column belirtilen tablo sütununu satır kümesindeki bir değişkene bağlar. OLE DB IAccessortabanlı bağlamaya katılabilen üye verilerini sınırlandırıyor. Bu öznitelik, OLE DB tüketici makroları BEGIN_COLUMN_MAP, END_COLUMN_MAP ve COLUMN_ENTRY kullanılarak normal olarak tanımlanan sütun eşlemesini ayarlar. Bunlar OLE DB DBBINDING yapısını , belirtilen sütunu bağlamak için işler. db_column özniteliğiyle işaretlediğiniz her üye, sütun eşlemesinde bir sütun girişi biçiminde bir girdi kaplar. Bu nedenle, sütun eşlemesini, yani komut veya tablo sınıfına yerleştireceğiniz bu özniteliği çağırırsınız.

db_table veya db_command öznitelikleriyle birlikte db_column kullanın.

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.

Örnekler

Bu örnek, tablodaki bir sütunu veri long üyesine bağlar ve durum ve uzunluk alanlarını belirtir.

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

[ db_command(L"Select * from Products") ]
class CProducts {
   DBSTATUS m_dwProductIDStatus;
   DBLENGTH m_dwProductIDLength;

   [ db_column("1", status="m_dwProductIDStatus", length="m_dwProductIDLength") ] LONG m_ProductID;
};

Bu örnek, bir karakter dizesine, zaman damgasına ve DB_NUMERIC tamsayıya longdört sütunu bu sırayla bağlar.

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

[ db_command(L"Select * from Products") ]
class CProducts {
   [db_column("1")] LONG m_OrderID;
   [db_column("2")] TCHAR m_CustomerID[6];
   [db_column("4")] DB_NUMERIC m_OrderDate;
   [db_column("7", dbtype="DBTYPE_NUMERIC")] DB_NUMERIC m_ShipVia;
};

Gereksinimler

Öznitelik bağlamı	Değer
Şunlar için geçerlidir:	class, struct, member, method
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
Sınıf Öznitelikleri