データベース オブジェクト

  • [アーティクル]

Database オブジェクトはインストーラー データベースにアクセスします。

Database オブジェクトは、スコープ外に取り出された場合、またはそれに関連付けられているオブジェクト変数が null に設定されている場合に解放されます。 すべての永続的な変更を書き出すには、Database オブジェクトを解放する前に Commit メソッドを呼び出す必要があります。 Commit メソッドが呼び出されない場合、オブジェクトの破棄時にインストーラーによって暗黙的なロールバックが実行されます。

クライアントは、データ アクセスに次の手順を使用できます。

API シーケンス処理のクエリを実行するには

  1. OpenDatabase または Installer オブジェクトを呼び出して、Database オブジェクトを取得します。
  2. Database オブジェクトの OpenView メソッドを呼び出して、SQL 文字列を使用してクエリを開始します。
  3. Record オブジェクトにクエリ パラメーターを設定し、View オブジェクトの Execute メソッドを呼び出してデータベース クエリを実行します。 これにより、フェッチまたは更新できる結果が生成されます。
  4. View オブジェクトの Fetch メソッドを繰り返し呼び出して、Record オブジェクトを返します。
  5. View オブジェクトの Modify メソッドを使用して、Fetch メソッドによって取得された Record オブジェクトのデータベース行を更新します。
  6. View オブジェクトの Close メソッドを呼び出して、クエリとフェッチされていないレコード (ある場合) を解放します。
  7. Database オブジェクトの Commit メソッドを呼び出して、データベースの更新を保持します。

メンバー

Database オブジェクトには、次の種類のメンバーがあります。

メソッド

Database オブジェクトには、次のメソッドがあります。

方法 説明
ApplyTransform 変換をこのデータベースに適用します。
Commit データベースの永続的な形式を確定します。
CreateTransformSummaryInfo 既存の変換ファイルの概要情報ストリームを作成して設定します。
EnableUIPreview インストーラー データベースに格納されているユーザー インターフェイス ダイアログ ボックスを表示するために必要なサポートを提供することで、ダイアログ ボックスとビルボードの作成を容易にします。
[エクスポート] 指定したテーブルの構造とデータをテキスト アーカイブ ファイルにコピーします。
GenerateTransform 変換を作成します。
[インポート] テキスト アーカイブ ファイルからデータベース テーブルをインポートします。
Merge 参照データベースを基本データベースとマージします。
OpenView SQL 文字列で指定されたクエリを表す View オブジェクトを返します。

プロパティ

Database オブジェクトには、次のプロパティがあります。

プロパティ 説明
DatabaseState
 データベースの永続化状態を返します。
PrimaryKeys
 テーブル名と列名 (主キーを構成する) を含む Record オブジェクトを返します。
SummaryInformation (Database オブジェクト)
 概要情報ストリームのプロパティの確認、更新、追加に使用できる SummaryInfo オブジェクトを返します。
TablePersistent
 テーブルの永続化状態を返します。

必要条件

要件 値
バージョン
 Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー
[DLL]
Msi.dll
IID
 IID_IDatabase が 000C109D-0000-0000-C000-000000000046 と義されている

こちらもご覧ください

Windows インストーラーのスクリプト作成の例