db_source

Создает подключение к источнику данных.

Синтаксис

[ db_source(db_source, name, hresult) ]

Параметры

db_source
Строка подключения используется для подключения к источнику данных. Формат строка подключения см. в разделе "Строки подключения" и "Ссылки на данные" в пакете SDK для компонентов доступа к данным (MDAC).

name
(Необязательно) При использовании db_source в классе имя является экземпляром объекта источника данных с атрибутом db_source , примененным к нему (см. пример 1). При использовании db_source встроенной в реализации метода имя является переменной (локальной для метода), которую можно использовать для доступа к источнику данных (см. пример 2). Это имя передается параметру source_name db_command для связывания источника данных с командой.

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

Замечания

db_source создает объект CDataSource и объект CSession, который вместе представляет соединение с источником данных потребителя OLE DB.

При использовании db_source в классе CSession объект становится членом класса.

При использовании db_source в методе внедренный код будет выполняться в области метода, а CSession объект создается в виде локальной переменной.

db_source добавляет свойства источника данных в класс или в методе. Он используется в сочетании с db_command (который принимает параметр имени db_source в качестве параметра source_name).

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

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

Пример

Этот пример вызывает db_source в классе, чтобы создать подключение к источнику ds данных с помощью базы данных Northwind. ds — это дескриптор источника данных, который можно использовать внутри CMyCommand класса.

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

[
  db_source(L"my_connection_string", name="ds"),
  db_command(L"select * from Products")
]
class CMyCommand {};

Требования

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

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

См. также

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