Upgrade-Tabelle

  • Artikel

Die Tabelle Upgrade enthält Informationen, die bei größeren Upgrades erforderlich sind. Um die Upgradefunktionen des Installationsprogramms zu aktivieren, muss jedes Paket über eine Eigenschaft UpgradeCode und eine Upgrade-Tabelle verfügen. Jeder Datensatz in der Upgrade-Tabelle enthält eine Kombination aus Upgradecode, Produktversion und Sprachinformationen, die verwendet werden, um eine Reihe von Produkten zu identifizieren, die von dem Upgrade betroffen sind. Wenn die Aktion FindRelatedProducts erkennt, dass ein betroffenes Produkt auf dem System installiert ist, fügt sie den Produktcode an eine Eigenschaft in der Spalte ActionProperty der Tabelle Upgrade an. Die Aktion RemoveExistingProducts und die Aktion MigrateFeatureStates entfernen oder migrieren nur die in der Spalte ActionProperty aufgeführten Produkte.

Die Upgrade-Tabelle enthält die in der folgenden Tabelle dargestellten Spalten.

Spalte Typ Schlüssel Nullwerte zulässig
UpgradeCode GUID J N
VersionMin Text J J
VersionMax Text J J
Sprache Text J J
Attribute Integer J N
Remove (Entfernen) Formatted N J
ActionProperty Identifier N N

 

Spalten

UpgradeCode

Die Eigenschaft UpgradeCode in dieser Spalte gibt den Upgradecode aller Produkte an, die von der Aktion FindRelatedProducts erkannt werden sollen.

VersionMin

Untere Grenze der Von FindRelatedProducts erkannten Produktversionen. Geben Sie msidbUpgradeAttributesVersionMinInclusive in Attribute ein, um VersionMin in den Bereich einzuschließen. Wenn VersionMin gleich einer leeren Zeichenfolge ("") ist, wird sie gleich 0 ausgewertet. Wenn VersionMin NULL ist, ignoriert FindRelatedProducts msidbUpgradeAttributesVersionMinInclusive und erkennt alle vorherigen Versionen. VersionMin und VersionMax dürfen nicht beide NULL sein.

VersionMin muss eine gültige Produktversion sein, wie für die Eigenschaft ProductVersion beschrieben. Beachten Sie, dass Windows Installer nur die ersten drei Felder der Produktversion verwendet. Wenn Sie ein viertes Feld in Ihre Produktversion einbeziehen, ignoriert das Installationsprogramm das vierte Feld.

VersionMax

Untere Grenze der von der Aktion FindRelatedProducts erkannten Produktversionen. Geben Sie msidbUpgradeAttributesVersionMaxInclusive in Attribute ein, um VersionMax in den Bereich einzuschließen. Wenn VersionMax eine leere Zeichenfolge ("") ist, wird sie gleich 0 ausgewertet. Wenn VersionMax NULL ist, ignoriert FindRelatedProducts msidbUpgradeAttributesVersionMaxInclusive und erkennt alle Produktversionen, die größer (oder größer oder gleich) der durch VersionMin und msidbUpgradeAttributesVersionMinInclusive angegebenen unteren Grenze sind. VersionMin und VersionMax dürfen nicht beide NULL sein.

VersionMax muss eine gültige Produktversion sein, wie für die Eigenschaft ProductVersion beschrieben. Beachten Sie, dass Windows Installer nur die ersten drei Felder der Produktversion verwendet. Wenn Sie ein viertes Feld in Ihre Produktversion einbeziehen, ignoriert das Installationsprogramm das vierte Feld.

Language

Der Satz von Sprachen, die von FindRelatedProducts erkannt wurden. Geben Sie eine Liste mit numerischen Sprachbezeichnern (LANGID) ein, die durch Kommas getrennt sind. Geben Sie msidbUpgradeAttributesLanguagesExclusive in Attribute ein, um alle Sprachen zu erkennen, die ausschließlich in Language aufgeführt sind. Wenn Language NULL oder eine leere Zeichenfolge ("") ist, ignoriert FindRelatedProducts msidbUpgradeAttributesLanguagesExclusive und erkennt alle Sprachen.

Attributes

Diese Spalte enthält Bitflags, die Attribute der Upgradetabelle angeben.

Name des Bitflags Decimal Hexadezimal attribute
msidbUpgradeAttributesMigrateFeatures 1 0x001 Migriert Featurezustände, indem die Logik in der Aktion MigrateFeatureStates aktiviert wird.
msidbUpgradeAttributesOnlyDetect 2 0x002 Erkennt Produkte und Anwendungen, entfernt aber nicht.
msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Setzt die Installation fort, wenn ein Produkt oder eine Anwendung nicht entfernt wurde.
msidbUpgradeAttributesVersionMinInclusive 256 0x100 Erkennt den Versionsbereich, einschließlich des Werts in VersionMin.
msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Erkennt den Versionsbereich, einschließlich des Werts in VersionMax.
msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Erkennt alle Sprachen mit Ausnahme der in der Spalte Sprache aufgeführten Sprachen.

 

Remove

Das Installationsprogramm legt die Eigenschaft REMOVE auf Features fest, die in dieser Spalte angegeben sind. Die zu entfernenden Features können zur Laufzeit bestimmt werden. Die in diesem Feld eingegebeneFormatted Zeichenfolge muss zu einer durch Trennzeichen getrennten Liste von Featurenamen ausgewertet werden. Beispiel: [Feature1],[Feature2],[Feature3]. Es werden keine Features entfernt, wenn das Feld formatierten Text enthält, der zu einer leeren Zeichenfolge ("") ausgewertet wird. Das Installationsprogramm legt REMOVE=ALL nur fest, wenn das Feld Remove leer ist. Beachten Sie den Unterschied zwischen einer leeren Zeichenfolge und einem leeren Feld. Wenn das Feld leer ist, ist es NULL.

ActionProperty

Wenn die Aktion FindRelatedProducts erkennt, dass ein zusammenhängendes Produkt auf dem System installiert ist, fügt sie den Produktcode an eine Eigenschaft in der in diesem Feld angegebenen Spalte an. Die in dieser Spalte angegebene Eigenschaft muss eine öffentliche Eigenschaft sein, und der Paketautor muss die Eigenschaft der Eigenschaft SecureCustomProperties hinzufügen. Jede Zeile in der Tabelle Upgrade muss über einen eindeutigen Wert ActionProperty verfügen. Nach FindRelatedProducts ist der Wert dieser Eigenschaft eine Listenproduktcodes, getrennt durch Semikolons (;), die im System erkannt wurden.

Validierung

ICE03
ICE06
ICE46
ICE61
ICE66