db_param

Belirtilen üye değişkenini bir giriş veya çıkış parametresiyle ilişkilendirir ve değişkeni sınırlandırır.

Sözdizimi

[ db_param(ordinal, paramtype="DBPARAMIO_INPUT", dbtype, precision, scale, status, length) ]

Parametreler

Sıralı
Verilerin bağlandığı satır kümesindeki bir alana karşılık gelen sütun numarası (DBCOLUMNINFO sıralı).

paramtype
(İsteğe bağlı) Parametresi için ayarlanacağı tür. Sağlayıcılar yalnızca temel alınan veri kaynağı tarafından desteklenen parametre G/Ç türlerini destekler. Tür, bir veya daha fazla DBPARAMIOENUM değerinin birleşimidir:

• DBPARAMIO_INPUT Giriş parametresi.

• DBPARAMIO_OUTPUT Bir çıkış parametresi.

• DBPARAMIO_NOTPARAM Erişimcinin parametresi yoktur. Satır erişimcilerinde bu değerin ayarlanması eParamIO , kullanıcıya parametrelerin yoksayıldığını anımsatır.

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 öğesinin açıklamasına bPrecision 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_param komutlarda kullandığınız parametreleri tanımlar; bu nedenle ile db_commandkullanırsınız. Örneğin, SQL sorgularındaki veya saklı yordamlardaki parametreleri bağlamak için db_param kullanabilirsiniz. Saklı yordamdaki parametreler soru işaretleri (?) ile gösterilir ve veri üyelerini parametrelerin görüntülendiği sırayla bağlamanız gerekir.

db_param, OLE DB ICommandWithParameterstabanlı bağlamaya katılabilen üye verilerini sınırlandırmaktadır. Belirtilen parametre için parametre türünü (giriş veya çıkış), OLE DB türünü, duyarlığı, ölçeği, durumu ve uzunluğunu ayarlar. Bu öznitelik OLE DB tüketici makrolarını BEGIN_PARAM_MAP ekler... END_PARAM_MAP. db_param özniteliğiyle işaretlediğiniz her üye, haritada bir COLUMN_ENTRY biçiminde bir girdi kaplar.

db_param, db_table veya db_command öznitelikleriyle birlikte kullanılı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.

Örnek

Aşağıdaki örnek, Northwind veritabanındaki SalesbyYear saklı yordamını temel alan bir komut sınıfı oluşturur. Saklı yordamdaki ilk parametreyi değişkeniyle m_RETURN_VALUE ilişkilendirir ve bunu bir çıkış parametresi olarak tanımlar. Son iki (giriş) parametresini ve m_Ending_Dateile m_Beginning_Date ilişkilendirir.

Aşağıdaki örnek değişkeni bir çıkış parametresiyle ilişkilendirir nOutput .

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

[ db_source(L"my_connection_string"),
  db_command(L"{ ? = CALL dbo.\"Sales by Year\"(?,?) }")
]
struct CSalesbyYear {
   DBSTATUS m_dwShippedDateStatus;
   DBSTATUS m_dwOrderIDStatus;
   DBSTATUS m_dwSubtotalStatus;
   DBSTATUS m_dwYearStatus;

   DBLENGTH m_dwShippedDateLength;
   DBLENGTH m_dwOrderIDLength;
   DBLENGTH m_dwSubtotalLength;
   DBLENGTH m_dwYearLength;

   // Bind columns
   [ db_column("1", status="m_dwShippedDateStatus", length="m_dwShippedDateLength") ] DBTIMESTAMP m_ShippedDate;
   [ db_column("2", status="m_dwOrderIDStatus", length="m_dwOrderIDLength") ] LONG m_OrderID;
   [ db_column("3", status="m_dwSubtotalStatus", length="m_dwSubtotalLength") ] CURRENCY m_Subtotal;
   [ db_column("4", status="m_dwYearStatus", length="m_dwYearLength") ] TCHAR m_Year[31];

   // Bind parameters
   [ db_param("1", paramtype="DBPARAMIO_OUTPUT") ] LONG m_RETURN_VALUE;
   [ db_param("2", paramtype="DBPARAMIO_INPUT") ] DBTIMESTAMP m_Beginning_Date;
   [ db_param("3", paramtype="DBPARAMIO_INPUT") ] DBTIMESTAMP m_Ending_Date;
};

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