Mutakhirkan Tabel

Tabel Peningkatan berisi informasi yang diperlukan selama peningkatan besar. Untuk sepenuhnya mengaktifkan kemampuan peningkatan alat penginstal, setiap paket harus memiliki properti UpgradeCode dan tabel Peningkatan. Setiap rekaman dalam tabel Peningkatan memberikan kombinasi karakteristik kode peningkatan, versi produk, dan informasi bahasa yang digunakan untuk mengidentifikasi sekumpulan produk yang terpengaruh oleh peningkatan. Ketika tindakan FindRelatedProducts mendeteksi produk yang terpengaruh yang diinstal pada sistem, tindakan tersebut menambahkan kode produk ke properti yang ditentukan di kolom ActionProperty. Tindakan RemoveExistingProducts dan tindakan MigrateFeatureStates hanya menghapus atau memigrasikan produk yang tercantum di kolom ActionProperty.

Tabel Peningkatan berisi kolom yang diperlihatkan dalam tabel berikut ini.

Kolom Jenis Kunci Dapat diubah ke null
UpgradeCode GUID Y N
VersionMin Teks Y Y
VersionMax Teks Y Y
Bahasa Teks Y Y
Atribut Bilangan bulat Y N
Hapus Diformat N Y
ActionProperty Pengidentifikasi N N

 

Kolom

UpgradeCode

Properti UpgradeCode di kolom ini menentukan kode peningkatan semua produk yang akan dideteksi oleh tindakan FindRelatedProducts .

VersionMin

Batas bawah rentang versi produk yang terdeteksi oleh FindRelatedProducts. Masukkan msidbUpgradeAttributesVersionMinInclusive di Atribut untuk menyertakan VersionMin dalam rentang. Jika VersionMin sama dengan string kosong ("") maka akan dievaluasi sama dengan 0. Jika VersionMin null, FindRelatedProducts mengabaikan msidbUpgradeAttributesVersionMinInclusive dan mendeteksi semua versi sebelumnya. VersionMin dan VersionMax tidak boleh null.

VersionMin harus merupakan versi produk yang valid seperti yang dijelaskan untuk properti ProductVersion . Perhatikan bahwa Windows Installer hanya menggunakan tiga bidang pertama dari versi produk. Jika Anda menyertakan bidang keempat dalam versi produk Anda, alat penginstal mengabaikan bidang keempat.

VersionMax

Batas atas rentang versi produk yang terdeteksi oleh tindakan FindRelatedProducts . Masukkan msidbUpgradeAttributesVersionMaxInclusive di Atribut untuk menyertakan VersionMax dalam rentang. Jika VersionMax adalah string kosong (""), maka akan dievaluasi sama dengan 0. Jika VersionMax null, FindRelatedProducts mengabaikan msidbUpgradeAttributesVersionMaxInclusive dan mendeteksi semua versi produk yang lebih besar dari (atau lebih besar dari atau sama dengan) batas bawah yang ditentukan oleh VersionMin dan msidbUpgradeAttributesVersionMinInclusive. VersionMin dan VersionMax tidak boleh null.

VersionMax harus berupa versi produk yang valid seperti yang dijelaskan untuk properti ProductVersion . Perhatikan bahwa Windows Installer hanya menggunakan tiga bidang pertama dari versi produk. Jika Anda menyertakan bidang keempat dalam versi produk Anda, alat penginstal mengabaikan bidang keempat.

Bahasa

Kumpulan bahasa yang terdeteksi oleh FindRelatedProducts. Masukkan daftar pengidentifikasi bahasa numerik (LANGID) yang dipisahkan oleh koma. Masukkan msidbUpgradeAttributesLanguagesExclusive di Atribut untuk mendeteksi semua bahasa yang tidak termasuk bahasa yang tercantum dalam Bahasa. Jika Bahasa null atau string kosong (""), FindRelatedProducts mengabaikan msidbUpgradeAttributesLanguagesExclusive dan mendeteksi semua bahasa.

Atribut

Kolom ini berisi bendera bit yang menentukan atribut tabel Peningkatan.

Nama bendera bit Desimal Heksadesimal Atribut
msidbUpgradeAttributesMigrateFeatures 1 0x001 Memigrasikan status fitur dengan mengaktifkan logika dalam tindakan MigrateFeatureStates .
msidbUpgradeAttributesOnlyDetect 2 0x002 Mendeteksi produk dan aplikasi tetapi tidak menghapus.
msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Melanjutkan penginstalan setelah kegagalan untuk menghapus produk atau aplikasi.
msidbUpgradeAttributesVersionMinInclusive 256 0x100 Mendeteksi rentang versi termasuk nilai di VersionMin.
msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Mendeteksi rentang versi termasuk nilai di VersionMax.
msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Mendeteksi semua bahasa, tidak termasuk bahasa yang tercantum di kolom Bahasa.

 

Menghapus

Alat penginstal mengatur properti REMOVE ke fitur yang ditentukan dalam kolom ini. Fitur yang akan dihapus dapat ditentukan pada durasi. String Yang diformat yang dimasukkan dalam bidang ini harus dievaluasi ke daftar nama fitur yang dibatasi koma. Misalnya: [Feature1],[Feature2],[Feature3]. Tidak ada fitur yang dihapus jika bidang berisi teks yang diformat yang dievaluasi ke string kosong (""). Alat penginstal mengatur REMOVE=ALL hanya jika bidang Hapus kosong. Perhatikan perbedaan antara string kosong dan bidang kosong. Jika bidang kosong, bidang tersebut null.

ActionProperty

Ketika tindakan FindRelatedProducts mendeteksi produk terkait yang diinstal pada sistem, tindakan tersebut menambahkan kode produk ke properti yang ditentukan di bidang ini. Properti yang ditentukan dalam kolom ini harus merupakan properti publik dan pembuat paket harus menambahkan properti ke properti SecureCustomProperties . Setiap baris dalam tabel Peningkatan harus memiliki nilai ActionProperty yang unik. Setelah FindRelatedProducts, nilai properti ini adalah kode produk daftar, dipisahkan oleh titik koma (;), terdeteksi pada sistem.

Validasi

ICE03
ICE06
ICE46
ICE61
ICE66