Metode Database.Merge

Metode Penggabungan objek Database menggabungkan database referensi dengan database dasar.

Sintaks

Database.Merge(
  reference,
  errorTable
)

Parameter

referensi

Objek Database yang diperlukan untuk digabungkan ke dalam database.

errorTable

Nama opsional tabel untuk berisi nama tabel yang berisi konflik penggabungan, jumlah baris yang bertentangan dalam tabel, dan referensi ke tabel dengan konflik penggabungan.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Fungsi MsiDatabaseMerge dan metode Penggabungan objek Database tidak dapat digunakan untuk menggabungkan modul yang disertakan dalam paket penginstalan. Mereka tidak boleh digunakan untuk menggabungkan Modul Penggabungan ke dalam paket Pemasang Windows. Untuk menyertakan modul penggabungan dalam paket penginstalan, penulis paket penginstalan harus mengikuti panduan yang dijelaskan dalam topik Menerapkan Modul Penggabungan .

Metode Gabungkan tidak menyalin file kabinet yang disematkan atau transformasi tersemat dari database referensi ke dalam database target. Aliran data yang disematkan yang tercantum dalam Tabel Biner atau Tabel Ikon disalin dari database referensi ke database target. Penyimpanan yang disematkan dalam database referensi tidak disalin ke database target.

Jika tidak ada tabel yang disediakan, pesan kesalahan umum menyediakan jumlah tabel yang berisi konflik penggabungan. Tabel apa pun dapat diteruskan, tetapi semua kolom lainnya harus dapat diubah ke null karena operasi untuk memperbarui Tabel Kesalahan gagal jika kolom tidak dapat diubah ke null. Tabel yang baru dibuat juga dapat diteruskan karena metode Gabungkan secara otomatis membuat kolom yang digunakannya jika konflik penggabungan ditemukan. Dua kolom digunakan untuk menyajikan konflik penggabungan. Kolom pertama adalah nama tabel dan kolom kunci primer. Kolom kedua adalah jumlah baris tabel yang mengalami kegagalan penggabungan.

Jika tabel dengan nama yang sama di kedua database tidak cocok dengan jumlah kunci primer, jenis kolom, jumlah kolom, atau nama kolom, metode Gabung gagal dan memposting pesan kesalahan yang menyatakan apa yang terjadi.

Agar tabel Kesalahan tetap ada, penangan kesalahan harus menerapkan database tempat tabel Kesalahan berada. Namun, penerapan ini harus dilakukan setelah menggunakan kolom ketiga untuk mendapatkan referensi ke tabel tempat konflik penggabungan terjadi.

Jika metode gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan metode LastErrorRecord .

Persyaratan

Persyaratan	Nilai
Versi	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP
DLL	Msi.dll
IID	IID_IDatabase didefinisikan sebagai 000C109D-0000-0000-C000-000000000046