データベース オブジェクト
Database オブジェクトはインストーラー データベースにアクセスします。
Database オブジェクトは、スコープ外に取り出された場合、またはそれに関連付けられているオブジェクト変数が null に設定されている場合に解放されます。 すべての永続的な変更を書き出すには、Database オブジェクトを解放する前に Commit メソッドを呼び出す必要があります。 Commit メソッドが呼び出されない場合、オブジェクトの破棄時にインストーラーによって暗黙的なロールバックが実行されます。
クライアントは、データ アクセスに次の手順を使用できます。
API シーケンス処理のクエリを実行するには
- OpenDatabase または Installer オブジェクトを呼び出して、Database オブジェクトを取得します。
- Database オブジェクトの OpenView メソッドを呼び出して、SQL 文字列を使用してクエリを開始します。
- Record オブジェクトにクエリ パラメーターを設定し、View オブジェクトの Execute メソッドを呼び出してデータベース クエリを実行します。 これにより、フェッチまたは更新できる結果が生成されます。
- View オブジェクトの Fetch メソッドを繰り返し呼び出して、Record オブジェクトを返します。
- View オブジェクトの Modify メソッドを使用して、Fetch メソッドによって取得された Record オブジェクトのデータベース行を更新します。
- View オブジェクトの Close メソッドを呼び出して、クエリとフェッチされていないレコード (ある場合) を解放します。
- 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] |
|
| IID |
IID_IDatabase が 000C109D-0000-0000-C000-000000000046 と義されている |