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


Класс CDaoDatabase

Представляет подключение к базе данных, до которой можно работать с переданным ей данные.

class CDaoDatabase : public CObject

Члены

Открытые конструкторы

Имя

Описание

CDaoDatabase::CDaoDatabase

Создает объект CDaoDatabase. Вызовите Открыть для подключения объекта в базе данных.

Открытые методы

Имя

Описание

CDaoDatabase::CanTransact

Возвращает ненулевое значение, если обозреватель транзакций базы данных.

CDaoDatabase::CanUpdate

Возвращает ненулевое значение, если объект CDaoDatabase быть обновляемым (не только для чтения).

CDaoDatabase::Close

Закрывает соединение с базой данных.

CDaoDatabase::Create

Создает базовый объект базы данных DAO и инициализирует объект CDaoDatabase.

CDaoDatabase::CreateRelation

Определяет новую связь между таблицами в базе данных.

CDaoDatabase::DeleteQueryDef

Удаляет объект QueryDef сохраненный в коллекции QueryDefs базы данных.

CDaoDatabase::DeleteRelation

Удаляет существующую связь между таблицами в базе данных.

CDaoDatabase::DeleteTableDef

Удаляет определение таблицы в базе данных. Это удаляет фактическая таблица и все ее данных.

CDaoDatabase::Execute

Выполняет запрос на изменение. Вызов Выполнить для запроса, который получает штрихи результатов исключение.

CDaoDatabase::GetConnect

Возвращает строку подключения, используемую для подключения объект CDaoDatabase к базе данных. Общий для ODBC.

CDaoDatabase::GetName

Возвращает имя базы данных, в настоящее время используется.

CDaoDatabase::GetQueryDefCount

Возвращает количество запросов, определенных для базы данных.

CDaoDatabase::GetQueryDefInfo

Возвращает сведения об указанном запросе, определенном в базе данных.

CDaoDatabase::GetQueryTimeout

Возвращает число секунд, после которого операции запроса к базе данных приурочат ожидания. Распространяется на весь последующий открыть добавляет новую, обновления и операции правки и другие операции на источник данных ODBC (только) как вызовы Выполнить.

CDaoDatabase::GetRecordsAffected

Возвращает число записей, затронутых последним обновлением, правкой или добавить операцию, либо вызовом Выполнить.

CDaoDatabase::GetRelationCount

Возвращает количество связей, определенных между таблицами в базе данных.

CDaoDatabase::GetRelationInfo

Возвращает сведения об указанной ссылки указанной между таблицами в базе данных.

CDaoDatabase::GetTableDefCount

Возвращает число таблиц, определенное в базе данных.

CDaoDatabase::GetTableDefInfo

Возвращает сведения об указанной таблицы в базе данных.

CDaoDatabase::GetVersion

Возвращает версию компонента database engine, связанного с базой данных.

CDaoDatabase::IsOpen

Возвращает ненулевое значение, если объект CDaoDatabase в настоящее время для подключения к базе данных.

CDaoDatabase::Open

Устанавливает соединение с базой данных.

CDaoDatabase::SetQueryTimeout

Задает число секунд, после которого операции запроса к базе данных (на источник данных ODBC) приурочат ожидания. Распространяется на весь последующий открыть добавляет новую, обновления и удаления.

Открытые члены данных

Имя

Описание

CDaoDatabase::m_pDAODatabase

Указатель на базовый объект базы данных DAO.

CDaoDatabase::m_pWorkspace

Указатель на объект CDaoWorkspace, содержащего базу данных и указывающий его место транзакции.

Заметки

Дополнительные сведения о поддерживаемых форматах базы данных см. в разделе GetName функции-члена. Можно иметь активные одного или нескольких объектов CDaoDatabase одновременно в заданном "область", представленного объектом CDaoWorkspace. Область поддерживает коллекцию открытых объектов базы данных, вызванную коллекция баз данных.

Примечание

Классы баз данных MFC DAO MFC отличаются от классов баз данных на основе ODBC.Все имена классов базы данных DAO имеют префикс "CDao".Класс CDaoDatabase предоставляет интерфейс, аналогичный с сигнатурой класса CDatabase ODBC.Основное отличие состоит в том, что CDatabase обращается к engine через ODBC (ODBC) и драйвер ODBC engine.Данные доступа CDaoDatabase через объект доступа к данным (DAO) на основе компонента database engine для jet (Майкрософт).В общем случае классы MFC DAO способны на основе более чем классы MFC на основе ODBC; DAO- на основе классы могут получить доступ к данным, включая через драйвер ODBC через собственный компонент database engine.DAO- на основе классов также поддерживают операции языка описания данных DDL (язык DDL), такие как добавление таблицы с помощью классов DAO непосредственно, без вызова.

Использование

Можно создать объекты базы данных неявно при создании объектов набора записей. Однако можно также создать объекты базы данных явным образом. Для использования существующей базы данных к получению с CDaoDatabase выполните одно из следующих действий:

  • Создайте объект CDaoDatabase, передав указатель на открытый объект CDaoWorkspace.

  • Создайте объект CDaoDatabase или без указания область (MFC создает временный объект области).

Чтобы создать новую базу данных Microsoft jet (.MDB), создайте объект CDaoDatabase и вызовите его функцию-член Создание. Не вызывайте Открыть после Создать.

Чтобы открыть существующую базу данных создайте объект CDaoDatabase и вызовите его функцию-член Открытие.

Любые из этих методов добавить объект базы данных DAO к базам данных коллекции область, и открывает подключение к данным. При построении объектов CDaoRecordset, затем CDaoTableDef или CDaoQueryDef для работы в подключенной базе данных, передайте конструкторами для этих объектов указатель на объект CDaoDatabase. Завершив использовать соединение, вызовите функцию-член Закрыть и уничтожить объект CDaoDatabase. Закрыть закрывает все наборы записей не закрыли ранее.

Транзакции

Транзакционная обработка базы данных предоставляется на уровне области — см. в разделе BeginTrans, CommitTrans и функции-члены откат класса CDaoWorkspace.

Подключения ODBC

Рекомендуемый способ работы с источником данных ODBC вложить внешние таблицы в базе данных Microsoft jet (.MDB).

Коллекции

Каждая база данных хранит собственные коллекции tabledef, QueryDef, набора записей и объектов отношений. Класс CDaoDatabase предоставляет функции-члены для обработки этих объектов.

Примечание

Объекты хранятся в DAO, а не в объекте базы данных MFC.MFC предоставляет классы для tabledef, QueryDef и объектов наборов записей, но не для объектов отношений.

Иерархия наследования

CObject

CDaoDatabase

Требования

Header: afxdao.h

См. также

Ссылки

Класс CObject

Диаграмма иерархии

Класс CDaoWorkspace

Класс CDaoRecordset

Класс CDaoTableDef

Класс CDaoQueryDef

Класс CDatabase

Класс CDaoException