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


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

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

См. также

Другие ресурсы

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

Attributes Samples