Объект базы данных

Объект Database обращается к базе данных установщика.

Объект Database освобождается, когда он либо выходит из области действия, либо когда объектная переменная, связанная с ней, имеет значение NULL. Перед освобождением объекта Database необходимо вызвать метод Commit, чтобы записать все постоянные изменения. Если метод Commit не вызывается, установщик выполняет неявный откат при уничтожении объектов.

Клиент может использовать следующую процедуру для доступа к данным.

Запрос последовательности API

  1. Получите объект Database , вызвав OpenDatabase или объект Installer .
  2. Инициируйте запрос с помощью строки SQL, вызвав метод OpenView объекта Database .
  3. Задайте параметры запроса в объекте Record и выполните запрос базы данных, вызвав метод Execute объекта View . Это приводит к получению или обновлению результата.
  4. Вызовите метод Fetch объекта View несколько раз, чтобы вернуть объекты Record .
  5. Обновление строк базы данных объекта Record , полученного методом Fetch с помощью метода Modify объекта View .
  6. Отпустите запрос и все неисчерпированные записи, вызвав метод Close объекта View .
  7. Сохраните обновления базы данных, вызвав метод Commit объекта Database .

Элементы

Объект Database имеет следующие типы элементов:

Методы

Объект Database имеет эти методы.

Метод Описание
ApplyTransform Применяет преобразование к этой базе данных.
Совершить Завершает постоянную форму базы данных.
CreateTransformSummaryInfo Создает и заполняет поток сводной информации существующего файла преобразования.
EnableUIPreview Упрощает создание диалоговых окон и рекламных щитов, предоставляя поддержку, необходимую для просмотра диалоговых окон пользовательского интерфейса, хранящихся в базе данных установщика.
Экспорт Копирует структуру и данные из указанной таблицы в текстовый архивный файл.
GenerateTransform Создает преобразование.
Импорт Импортирует таблицу базы данных из текстового архивного файла.
Объединить Объединяет эталонную базу данных с базовой базой данных.
Openview Возвращает объект View , представляющий запрос, заданный строкой SQL.

Свойства

Объект Database имеет эти свойства.

Свойство Описание:
DatabaseState
Возвращает состояние сохраняемости базы данных.
PrimaryKeys
Возвращает объект Record , содержащий имя таблицы и имена столбцов (состоящие из первичных ключей).
SummaryInformation (объект Database)
Возвращает объект SummaryInfo , который можно использовать для проверки, обновления и добавления свойств в поток сводной информации.
TablePersistent
Возвращает состояние сохраняемости таблицы.

Требования

Требование Значение
Версия
Windows Установщик 5.0 на Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Windows Установщик 4.0 или установщик Windows 4.5 на Windows Server 2008 или Windows Vista. Установщик Windows на Windows Server 2003 или Windows XP
DLL
Msi.dll
IID
IID_IDatabase определяется как 000C109D-0000-0000-C000-000000000046

См. также раздел

Примеры сценариев установщика Windows