Sdílet prostřednictvím


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

Viz také

Další zdroje

Atributy příjemce technologie OLE DB

Atributy třídy

Attributes Samples