db_column

Artykuł
02/27/2013

Określona kolumna jest powiązana zmiennej w zestawie wierszy.

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

Parametry

ordinal
Liczba porządkowa kolumny (DBCOLUMNINFO porządkowej) lub nazwa kolumny (ciąg ANSI lub Unicode) odpowiadającą pola wierszy, do którego należy powiązać dane.Jeśli używasz liczb, można pominąć kolejne liczby porządkowe (na przykład: 1, 2, 3, 5).Nazwa może zawierać spacji, jeśli je obsługuje dostawcy OLE DB, którego używasz.Na przykład można użyć jednej z następujących formatów:
```
[db_column("2")] TCHAR szCity[30];
[db_column(L"city_name")] TCHAR szCity[30];
```
Typ dbType (opcjonalnie)
OLE DB Wskaźnika typu dla wpisu kolumny.
dokładność (opcjonalnie)
Dokładność stosowaną dla wpisu kolumny.Aby uzyskać szczegółowe informacje, zobacz opis bPrecision elementu struktury DBBINDING
Skala (opcjonalnie)
Skalę stosowaną dla wpisu kolumny.Aby uzyskać szczegółowe informacje, zobacz opis bScale elementu struktury DBBINDING
Stan (opcjonalnie)
Zmienna członka, służący do przechowywania stanu w tej kolumnie.Stan wskazuje, czy wartość kolumny jest wartość danych lub inne wartości, takie jak NULL.Możliwe wartości, zobacz stanu w OLE DB Programmer's Reference.
długość (opcjonalnie)
Zmienna członka, służący do przechowywania rozmiar kolumny w bajtach.

Uwagi

db_column jest powiązana kolumna tabeli określonej zmiennej w zestawie wierszy.Rozdziela go dane elementu członkowskiego, która może uczestniczyć w OLE DB IAccessor-oparte wiązania.Ten atrybut określa mapę kolumny zwykle definiowany przy użyciu makr konsumenta OLE DB BEGIN_COLUMN_MAP, END_COLUMN_MAP, i COLUMN_ENTRY.Te manipulować OLE DB DBBINDING struktury powiązać określona kolumna.Każdy członek znaku z db_column atrybut będą zajmować jeden zapis na mapie kolumny w formie zapisu kolumny.W związku z tym wymagają tego atrybutu gdzie należy umieścić mapę kolumny, to znaczy w klasie polecenia lub tabeli.

Użyj db_column w połączeniu z albo db_table lub db_command atrybuty.

Gdy dostawca atrybut konsumenta stosuje się ten atrybut do klasy, kompilator będzie Zmień nazwę klasy do _YourClassNameakcesor, gdzie YourClassName jest nazwą nadaną klasy i kompilator utworzy również klasy o nazwie YourClassName, który pochodzi od _YourClassNameakcesor.W widoku klasy widać obu klas.

Przykłady tego atrybutu, wykorzystaną w aplikacji, można znaleźć próbki AtlAgent, i MultiRead.

Przykład

Próbka ta wiąże kolumny w tabeli, aby long członek danych i określa status i długość pola.

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

Próbka ta wiąże się cztery kolumny do long, ciąg znaków, sygnatura czasowa i DB_NUMERIC integer, w tym celu.

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

Wymagania

Atrybutu kontekstu

Stosuje się do	Klasa, struct, członek, metoda
Powtarzalne	Nr
Wymagane atrybuty	Brak
Nieprawidłowe atrybuty	Brak

Aby uzyskać więcej informacji na temat kontekstów atrybutu, zobacz Kontekstów atrybutu.

Zobacz też

Inne zasoby

OLE DB konsumenta atrybutów

Atrybuty klas

Attributes Samples

Udostępnij za pośrednictwem