db_column
Zadaný sloupec se váže k proměnné v sadě řádků.
[ db_column(
ordinal,
dbtype,
precision,
scale,
status,
length
) ]
Parametry
ordinal
Číslo ordinální číslo sloupce (DBCOLUMNINFO pořadové číslo) nebo odpovídající pole v sadě řádků, do kterého chcete vytvořit vazbu dat název sloupce (řetězec ANSI nebo Unicode).Pokud pomocí čísla, můžete vynechat po sobě jdoucích řadové číslovky (například: 1, 2, 3, 5).Název může obsahovat mezery, pokud je podporuje zprostředkovatele OLE DB, který používáte.Například můžete použít některou z následujících formátů:[db_column("2")] TCHAR szCity[30]; [db_column(L"city_name")] TCHAR szCity[30];
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 strukturyMěřítko (volitelné)
Měřítko pro položku sloupce.Podrobnosti naleznete v popisu bScale prvek DBBINDING strukturyStav (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_column váže k proměnné v sadě řádků zadané tabulky sloupec.Ji vymezuje členských dat, která mohou být součástí OLE DB IAccessor-vazba založena.Tento atribut slouží k nastavení mapování sloupce obvykle definovány pomocí makra spotřebitele OLE DB BEGIN_COLUMN_MAP, END_COLUMN_MAP, a COLUMN_ENTRY.Tyto manipulace s OLE DB DBBINDING struktury zadaný sloupec svázat.Každý člen označení s db_column atributu bude zabírat jedna položka v rozvržení sloupců ve formuláři položky sloupce.Proto volání tohoto atributu kde umístíte mapování sloupce, ve třídě příkazu nebo tabulky.
Použití db_column 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říklady tohoto atributu v aplikaci, viz vzorky AtlAgent, a MultiRead.
Příklad
Tento příklad vytvoří vazbu sloupce do tabulky dlouhý datový člen a určuje stav a délku pole.
// 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;
};
Tento příklad vytvoří vazbu čtyři sloupce dlouhý, řetězec znaků, časové razítko a DB_NUMERIC celé číslo v uvedeném pořadí.
// 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;
};
Požadavky
Atribut kontextu
V aplikacích |
Třída, struct, člen, metoda |
Opakovatelné |
Ne |
Požadované atributy |
Žádná |
Neplatné atributy |
Žádná |
Další informace o kontextech atribut, viz Kontexty atribut.