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

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

  • Статья

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

Объект Database освобождается при его извлечении из область или при присвоении связанной с ним переменной объекта значения NULL. Метод Commit необходимо вызвать перед освобождением объекта Database для записи всех постоянных изменений. Если метод 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 Применяет преобразование к этой базе данных.
Commit Завершает работу с постоянной формой базы данных.
CreateTransformSummaryInfo Создает и заполняет поток сводной информации существующего файла преобразования.
EnableUIPreview Упрощает создание диалоговых окон и рекламных щитов, предоставляя поддержку, необходимую для просмотра диалоговых окон пользовательского интерфейса, хранящихся в базе данных установщика.
Экспорт Копирует структуру и данные из указанной таблицы в текстовый архивный файл.
GenerateTransform Создает преобразование.
Импорт Импортирует таблицу базы данных из текстового архивного файла.
Объединить Объединяет эталонную базу данных с базовой базой данных.
Openview Возвращает объект View, представляющий запрос, заданный строкой SQL.

Свойства

Объект Database имеет следующие свойства.

Свойство Описание
DatabaseState
 Возвращает состояние сохраняемости базы данных.
PrimaryKeys
 Возвращает объект Record , содержащий имя таблицы и имена столбцов (состоящие из первичных ключей).
SummaryInformation (объект базы данных)
 Возвращает объект 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-00000000000046

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

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