db_source
Создает соединение с источником данных.
[ db_source(
db_source,
name,
hresult
) ]
Параметры
db_source
Строка подключения, используемая для подключения к источнику данных. Для формата строки соединения см. в разделе строки подключения и каналы передачи данных в пакете SDK для компонентов доступа к данным MDAC.Имя (необязательно)
При использовании db_source в классе Имя экземпляр объекта источника данных, имеющего db_source атрибут, примененный к нему (см. пример 1). При использовании db_source встроенный в реализации метода Имя локальная переменная (метод), которые могут быть использованы для доступа к источнику данных (см. пример 2). Передается таким Имя к source_name параметр db_command связать источник данных с командой.hresult (необязательный параметр)
Указывает переменную, получающую HRESULT этой команды базы данных. Если переменная не существует, то она будет автоматически вставлен с помощью атрибута.
Заметки
db_source создает a CDataSource и a CSession объект, который совместно представляют объекта-получателя соединение с источником данных OLE DB.
При использовании db_source в классе CSession объект становится элементом класса.
При использовании db_source в методе, введенный код будет выполняться в пределах области действия метода. CSession объект создан в качестве локальной переменной.
db_source добавляет свойства источника данных к классу или в методе. Он используется совместно с db_command (который принимает db_source Имя параметр как сво source_name параметр).
Когда поставщик атрибута объекта-получателя применяет этот атрибут к классу компилятор переименовывает класс, _YourClassNameметод доступа, где YourClassName имя указанного класса, и компилятор также создает класс YourClassName, что является производным от _YourClassNameметод доступа. В представлении классов отобразится оба класса.
Пример использования данного атрибута, используемого в приложении см. в разделе примеры AtlAgent и 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 {};
Требования
Контекст атрибута
Применение |
класс" structучастник, метод local |
Repeatable |
Нет |
Обязательные атрибуты |
None |
Недопустимые атрибуты |
None |
Дополнительные сведения о контекстах атрибута см. в разделе Контексты атрибута.