Table Upgrade

La table Upgrade contient les informations requises pendant les mises à niveau majeures. Pour activer les fonctionnalités de mise à niveau du programme d’installation, chaque package doit avoir une propriété UpgradeCode et une table Upgrade. Chaque enregistrement de la table Upgrade fournit une combinaison caractéristique de code de mise à niveau, de version du produit et d’informations de langue utilisées pour identifier un ensemble de produits affectés par la mise à niveau. Lorsque l’actionFindRelatedProducts détecte qu’un produit affecté est installé sur le système, elle ajoute le code de produit à une propriété dans la colonne ActionProperty. L’actionRemoveExistingProducts et l’action MigrateFeatureStates suppriment ou migrent uniquement les produits répertoriés dans la colonne ActionProperty.

La table Upgrade contient les colonnes indiquées dans le tableau suivant.

Colonne	Type	Clé	Nullable
UpgradeCode	GUID	O	N
VersionMin	Texte	O	O
VersionMax	Texte	O	O
Langage	Texte	O	O
Attributs	Integer	O	N
Supprimer	Formatted	N	O
ActionProperty	Identificateur	N	N

 

Colonnes

UpgradeCode

La propriété UpgradeCode de cette colonne spécifie le code de mise à niveau de tous les produits qui doivent être détectés par l’action FindRelatedProducts .

VersionMin

Limite inférieure de la plage de versions de produit détectées par FindRelatedProducts. Entrez msidbUpgradeAttributesVersionMinInclusive dans Attributs pour inclure VersionMin dans la plage. Si VersionMin est égal à une chaîne vide (« »), elle est évaluée de la même façon que 0. Si VersionMin a la valeur null, FindRelatedProducts ignore msidbUpgradeAttributesVersionMinInclusive et détecte toutes les versions précédentes. VersionMin et VersionMax ne doivent pas être null.

VersionMin doit être une version de produit valide, comme décrit pour la propriété ProductVersion . Notez que Windows Installer utilise uniquement les trois premiers champs de la version du produit. Si vous incluez un quatrième champ dans votre version de produit, le programme d’installation ignore le quatrième champ.

VersionMax

délimitation supérieure de la plage de versions de produit détectées par l’action FindRelatedProducts. SaisirmsidbUpgradeAttributesVersionMaxInclusive dans Attributs pour inclure VersionMax dans la plage. Si VersionMax est égal à une chaîne vide (« »), elle est évaluée de la même façon que 0. Si VersionMax a la valeur null, FindRelatedProducts ignore msidbUpgradeAttributesVersionMaxInclusive et détecte toutes les versions de produit supérieures (ou supérieures ou égales à) la limite inférieure spécifiée par VersionMin et msidbUpgradeAttributesVersionMinInclusive. VersionMin et VersionMax ne doivent pas être null.

VersionMax doit être une version de produit valide, comme décrit pour la propriété ProductVersion . Notez que Windows Installer utilise uniquement les trois premiers champs de la version du produit. Si vous incluez un quatrième champ dans votre version de produit, le programme d’installation ignore le quatrième champ.

Langue

Ensemble de langues détectés par FindRelatedProducts. Entrez une liste d’identificateurs de langue numériques (LANGID) séparés par des virgules. Entrez msidbUpgradeAttributesLanguagesExclusive dans Attributs pour détecter toutes les langues autres que celles répertoriées dans Langue. Si Language a la valeur null ou une chaîne vide («  »), FindRelatedProducts ignore msidbUpgradeAttributesLanguagesExclusive et détecte toutes les langues.

attributs

Cette colonne contient des indicateurs de bits spécifiant les attributs de la table Upgrade.

Nom de l’indicateur de bits	Decimal	Valeur hexadécimale	Attribut
msidbUpgradeAttributesMigrateFeatures	1	0x001	Migre les états des fonctionnalités en activant la logique dans l’action MigrateFeatureStates .
msidbUpgradeAttributesOnlyDetect	2	0x002	Détecte les produits et les applications, mais ne supprime pas.
msidbUpgradeAttributesIgnoreRemoveFailure	4	0x004	Continue l’installation en cas d’échec de la suppression d’un produit ou d’une application.
msidbUpgradeAttributesVersionMinInclusive	256	0x100	Détecte la plage de versions, y compris la valeur dans VersionMin.
msidbUpgradeAttributesVersionMaxInclusive	512	0x200	Détecte la plage de versions, y compris la valeur dans VersionMax.
msidbUpgradeAttributesLanguagesExclusive	1 024	0x400	Détecte toutes les langues, à l’exclusion des langues répertoriées dans la colonne Langue.

 

Supprimer

Le programme d’installation définit la propriété REMOVE sur les fonctionnalités spécifiées dans cette colonne. Les fonctionnalités à supprimer peuvent être déterminées au moment de l’exécution. La chaîne Formatted entrée dans ce champ doit être évaluée par une liste de noms de fonctionnalités délimitée par des virgules. Par exemple : [Feature1],[Feature2],[Feature3]. Aucune fonctionnalité n’est supprimée si le champ contient du texte mis en forme qui correspond à une chaîne vide («  »). Le programme d’installation définit REMOVE=ALL uniquement si le champ Supprimer est vide. Notez la différence entre une chaîne vide et un champ vide. Si le champ est vide, il est null.

ActionProperty

Lorsque l’actionFindRelatedProducts détecte qu’un produit affecté est installé sur le système, elle ajoute le code de produit à la propriété spécifiée dans ce champ. La propriété spécifiée dans cette colonne doit être une propriété publique et l’auteur du package doit ajouter la propriété à la propriété SecureCustomProperties . Chaque ligne de la table Upgrade doit avoir une valeur ActionProperty unique. Après FindRelatedProducts, la valeur de cette propriété est une liste de codes de produit, séparés par des points-virgules (;), détectés sur le système.

Validation

ICE03
ICE06
ICE46
ICE61
ICE66