Класс CDatabase

Статья
02/20/2013

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

class CDatabase : public CObject

Члены

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

Имя	Описание
CDatabase::CDatabase	Создает объект CDatabase.Объект необходимо инициализировать путем вызова OpenEx или Открыть.

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

Имя	Описание
CDatabase::BeginTrans	Запускает транзакцию" — "ряд реверзибельных вызовов AddNew, Изменить, Удалить и функции-членам Обновить класса CRecordset — на подключенном источнике данных.Источник данных должен поддерживать транзакции для BeginTrans иметь любой в силу.
CDatabase::BindParameters	Позволяет параметрам привязки перед вызовом CDatabase::ExecuteSQL.
CDatabase::Cancel	Отменяет асинхронную операцию или процесс из второго потока.
CDatabase::CanTransact	Возвращает ненулевое значение, если источник данных поддерживает транзакции.
CDatabase::CanUpdate	Возвращает ненулевое значение, если объект CDatabase быть обновляемым (не только для чтения).
CDatabase::Close	Закрывает соединение с источником данных.
CDatabase::CommitTrans	Завершает транзакцию, BeginTrans.Команды в транзакции, которые изменяют источник данных унесены.
CDatabase::ExecuteSQL	Выполняет инструкцию SQL.Отсутствуют записи данных не возвращаются.
CDatabase::GetBookmarkPersistence	Определяет операции, которые сохраняются в объектах до закладки набора записей.
CDatabase::GetConnect	Возвращает строку подключения, используемую для подключения ODBC объекта CDatabase к источнику данных.
CDatabase::GetCursorCommitBehavior	Определяет эффект зафиксировать транзакцию на открытом объекте набора записей.
CDatabase::GetCursorRollbackBehavior	Определяет эффект откатить транзакцию на открытом объекте набора записей.
CDatabase::GetDatabaseName	Возвращает имя базы данных, в настоящее время используется.
CDatabase::IsOpen	Возвращает ненулевое значение, если объект CDatabase в настоящее время для подключения к источнику данных.
CDatabase::OnSetOptions	Вызываемый платформой для задания стандартные параметры соединения.Реализация по умолчанию устанавливает значение времени ожидания запроса.Можно установить эти параметры впереди времени путем вызова SetQueryTimeout.
CDatabase::Open	Устанавливает соединение с источником данных (через драйвер ODBC).
CDatabase::OpenEx	Устанавливает соединение с источником данных (через драйвер ODBC).
CDatabase::Rollback	Обратитей изменения, внесенные во время текущей транзакции.Источник данных вернется к своему предыдущему состоянию, как определено в вызове BeginTrans, без изменений.
CDatabase::SetLoginTimeout	Задает число секунд, после которого попытка соединения с источником данных времени ожидания.
CDatabase::SetQueryTimeout	Задает число секунд, после которого операции запроса к базе данных приурочат ожидания.Распространяется на весь последующий набор записей Открыть, AddNew, Изменить и вызовы Удалить.

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

Имя	Описание
CDatabase::m_hdbc	Дескриптор соединения ODBC (ODBC) с источником данных.Тип HDBC.

Заметки

Источник данных конкретный экземпляр данных, который размещение некоторая система управления базами данных (СУБД).Примеры включают dBASE Microsoft SQL Server, Microsoft Access Borland и xBASE.Можно иметь активные одного или нескольких объектов CDatabase одновременно в приложении.

Примечание
При работе с DAO (DAO) классифицируете, а не классов ODBC (ODBC) использует класс CDaoDatabase.Дополнительные сведения см. в статье Общие сведения: программирование базы данных.

Для использования CDatabase, создайте объект CDatabase и вызовите его функцию-член OpenEx.Это открывает соединение.Если затем построения объектов CRecordset для работы на подключенном источнике данных, передайте конструктору набора записей указатель на объект CDatabase.Завершив использовать соединение, вызовите функцию-член Закрыть и уничтожить объект CDatabase.Закрыть закрывает все наборы записей не закрыли ранее.

Дополнительные сведения о CDatabase см. в разделе статьи источник данных (ODBC) и Общие сведения: программирование базы данных.