Upgradetabelle
Die Tabelle "Upgrade" enthält Informationen, die während wichtigsten Upgradeserforderlich sind. Um die Upgradefunktionen des Installationsprogramms vollständig zu aktivieren, sollte jedes Paket über eine UpgradeCode Eigenschaft und eine Upgrade-Tabelle verfügen. Jeder Datensatz in der Upgradetabelle bietet eine charakteristische Kombination aus Upgradecode, Produktversion und Sprachinformationen, die verwendet werden, um eine Reihe von Produkten zu identifizieren, die von dem Upgrade betroffen sind. Wenn die FindRelatedProducts--Aktion ein betroffenes Produkt erkennt, das auf dem System installiert ist, fügt sie den Produktcode an eine Eigenschaft an, die in der Spalte "ActionProperty" angegeben ist. Die aktion RemoveExistingProducts und die MigrateFeatureStates Aktion nur Produkte entfernen oder migrieren, die in der Spalte "ActionProperty" aufgeführt sind.
Die Tabelle "Upgrade" enthält die spalten, die in der folgenden Tabelle angezeigt werden.
| Spalte | Art | Schlüssel | Nullable |
|---|---|---|---|
| UpgradeCode | GUID- | Y | N |
| VersionMin | Y | Y | |
| VersionMax | Y | Y | |
| Sprache | Y | Y | |
| Attribute | ganze Zahl | Y | N |
| Entfernen | formatierte | N | Y |
| ActionProperty | Bezeichner | N | N |
Spalten
-
UpgradeCode
-
Die eigenschaft UpgradeCode in dieser Spalte gibt den Upgradecode aller Produkte an, die von der FindRelatedProducts-Aktion erkannt werden sollen.
-
VersionMin
-
Untere Grenze des Produktbereichs, der von FindRelatedProductserkannt wurde. Geben Sie msidbUpgradeAttributesVersionMinInclusive in Attribute ein, um VersionMin in den Bereich einzuschließen. Wenn VersionMin einer leeren Zeichenfolge ("") entspricht, 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 Die Produktversion einschließen, ignoriert das Installationsprogramm das vierte Feld.
-
VersionMax
-
Obere Grenze des Bereichs der Produktversionen, die von der aktion FindRelatedProducts erkannt wurden. Geben Sie msidbUpgradeAttributesVersionMaxInclusive in Attribute ein, um VersionMax in den Bereich einzuschließen. Wenn VersionMax eine leere Zeichenfolge ("") ist, wird sie mit 0 ausgewertet. Wenn VersionMax null ist, ignoriert FindRelatedProducts msidbUpgradeAttributesVersionMaxInclusive und erkennt alle Produktversionen, die größer (oder größer oder gleich) der untere Grenze sind, die durch VersionMin und msidbUpgradeAttributesVersionMinInclusiveangegeben ist. 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 Die Produktversion einschließen, ignoriert das Installationsprogramm das vierte Feld.
-
Sprache
-
Der Satz von Sprachen, die von FindRelatedProductserkannt wurden. Geben Sie eine Liste numerischer Sprachbezeichner (LANGID) ein, die durch Kommas getrennt sind. Geben Sie msidbUpgradeAttributesLanguagesExclusive in Attributes ein, um alle Sprachen zu erkennen, die ausschließlich in der Sprache aufgeführt sind. Wenn Language null oder eine leere Zeichenfolge ("") ist, ignoriert FindRelatedProducts msidbUpgradeAttributesLanguagesExclusive und erkennt alle Sprachen.
-
Attribute
-
Diese Spalte enthält Bitkennzeichnungen, die Attribute der Upgrade-Tabelle angeben.
Bitkennzeichnungsname Dezimal Hexadezimal Attribut msidbUpgradeAttributesMigrateFeatures 1 0x001 Migriert Featurezustände, indem die Logik in der MigrateFeatureStates Aktion 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 Bereich der Versionen, einschließlich des Werts in VersionMin. msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Erkennt den Bereich der Versionen, einschließlich des Werts in VersionMax. msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Erkennt alle Sprachen, mit Ausnahme der in der Spalte "Sprache" aufgeführten Sprachen. -
Entfernen
-
Das Installationsprogramm legt die REMOVE-Eigenschaft auf Features fest, die in dieser Spalte angegeben sind. Die zu entfernenden Features können zur Laufzeit bestimmt werden. Die in diesem Feld eingegebene formatierte Zeichenfolge muss in eine durch Trennzeichen getrennte Liste mit 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 dann fest, wenn das Feld "Entfernen" 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 FindRelatedProducts- Aktion ein verwandtes Produkt erkennt, das auf dem System installiert ist, fügt sie den Produktcode an die in diesem Feld angegebene Eigenschaft an. Die in dieser Spalte angegebene Eigenschaft muss eine öffentliche Eigenschaft sein, und der Paketautor muss die Eigenschaft der SecureCustomProperties-Eigenschaft hinzufügen. Jede Zeile in der Upgrade-Tabelle muss über einen eindeutigen ActionProperty-Wert verfügen. Nach FindRelatedProducts ist der Wert dieser Eigenschaft eine Listenproduktcodes, die durch Semikolons getrennt sind (;), die im System erkannt wurden.
Validierung