db_table

Статья
10/12/2023

Открывает таблицу OLE DB.

Синтаксис

[ db_table(db_table, name, source_name, hresult) ]

Параметры

db_table
Строка, указывающая имя таблицы базы данных (например, "Products").

имя
(Необязательно) Имя дескриптора, используемого для работы с таблицей. Этот параметр необходимо указать, если требуется вернуть несколько строк результатов. db_table создает переменную с указанным именем, которое можно использовать для обхода набора строк или выполнения нескольких запросов действий.

source_name
Переменная CSession или экземпляр класса с примененным атрибутом db_source, по которому выполняется команда (необязательно). См. описание db_source.

hresult
Определяет переменную, которая будет получать HRESULT от этой команды базы данных (необязательно). Если переменная не существует, она будет автоматически внедрена с помощью атрибута.

Замечания

db_table создает объект CTable, который используется потребителем OLE DB для открытия таблицы. Этот атрибут можно использовать только на уровне класса; Вы не можете использовать его встроенным образом. Используется для привязки столбцов таблицы к переменным; используется db_columndb_param для разделителя (задания типа параметра и т. д.) параметров.

Когда поставщик атрибутов потребителя применяет этот атрибут к классу, компилятор переименовывает класс в _YourClassName Accessor, где YourClassName — это имя, которое вы предоставили класс, и компилятор также создаст класс YourClassName, производный от _YourClassName Accessor. В представлении классов отображаются оба класса.

Пример

В следующем примере откроется таблица Products для использования CProducts.

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

[ db_table(L"dbo.Products") ]
class CProducts {
   [ db_column("1") ] LONG m_ProductID;
};

Пример этого атрибута, используемого в приложении, см. в разделе MultiRead.

Требования

Контекст атрибута	Значение
Относится к	`class`, `struct`
Повторяемый	No
Обязательные атрибуты	None
Недопустимые атрибуты	None

Дополнительные сведения о контекстах атрибутов см. в разделе Контексты атрибутов.

См. также

Атрибуты объекта-получателя OLE DB

Поделиться через