db_param

Článek
03/04/2013

Přidruží zadanou členské proměnné s parametrem vstupní nebo výstupní a vymezuje proměnné.

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

Parametry

ordinal
Číslo sloupce (DBCOLUMNINFO pořadové číslo) odpovídající pole v sadě řádků, do kterého chcete vytvořit vazbu dat.
paramtype (volitelné)
Typ nastavení parametru.Podporují pouze I/O typy parametrů, které podkladový zdroj dat podporuje.Typ je kombinace jednoho nebo více DBPARAMIOENUM hodnoty:
- DBPARAMIO_INPUT vstupní parametr.
- DBPARAMIO_OUTPUT výstupní parametr.
- DBPARAMIO_NOTPARAM přístupový objekt nemá žádné parametry.Nastavení eParamIO této hodnoty v řádku přístupové objekty upozorňuje uživatele parametry ignorovány.
Hodnota výčtu DbType (volitelné)
OLE DB Indikátoru pro položku sloupce.
přesnost (volitelné)
Přesnost pro položku sloupce.Podrobnosti naleznete v popisu bPrecision prvek DBBINDING struktury
Měřítko (volitelné)
Měřítko pro položku sloupce.Podrobnosti naleznete v popisu bScale prvek DBBINDING struktury
Stav (volitelné)
Členské proměnné použita k uchování stavu tohoto sloupce.Stav označuje, zda hodnota sloupce Hodnota data nebo jiné hodnoty, jako například NULL.Možné hodnoty viz stav v OLE DB Programmer's Reference.
Délka (volitelné)
Členské proměnné jímán v bajtech velikost sloupce.

Poznámky

db_param definuje parametry, které můžete použít příkazy; proto jej s pomocí db_command.Můžete například použít db_param k vytvoření vazby mezi parametry v dotazech SQL nebo uložené procedury.Parametry v uložené proceduře, jsou označena otazníky (?) a datové členy vazba v pořadí parametrů.

db_param vymezuje členských dat, která mohou být součástí OLE DB ICommandWithParameters-vazba založena.Nastaví typ parametru (vstupní nebo výstupní), typ OLE DB, přesnost, rozsah, stav a délky pro zadaný parametr.Tento atribut vloží makra spotřebitele OLE DB BEGIN_PARAM_MAP...END_PARAM_MAP.Každý člen označení s db_param atributu bude zabírat jednu položku na mapě ve formuláři COLUMN_ENTRY.

db_param se používá ve spojení s buď db_table nebo db_command atributy.

Pokud zprostředkovatel spotřebitele atribut použije tento atribut třídy, kompilátor bude přejmenovat třídu _YourClassNamepřístupový objekt, kde YourClassName je název třídy a kompilátor vytvoří také třídy nazvané YourClassName, který je odvozen z _YourClassNamepřístupový objekt.Třída zobrazení se zobrazí obě třídy.

Příklad

V následujícím příkladu vytvoří třídu příkazu na základě SalesbyYear uložené procedury v databázi Northwind.Je první parametr uložené procedury s associates m_RETURN_VALUE proměnné a definuje jako výstupní parametr.Jej přidružuje poslední dva parametry (vstupní) s m_Beginning_Date a m_Ending_Date.

V následujícím příkladu nOutput proměnné s výstupní parametr.

// 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;
};

Požadavky

Atribut kontextu

V aplikacích	Třída, struct, člen, metoda, místní
Opakovatelné	Ne
Požadované atributy	Žádná
Neplatné atributy	Žádná

Další informace o kontextech atribut, viz Kontexty atribut.

Viz také

Další zdroje

Atributy příjemce technologie OLE DB

Attributes Samples

Sdílet prostřednictvím