Mettre à niveau la table
La table Mise à niveau contient des informations requises pendant mises à niveau majeures. Pour activer entièrement les fonctionnalités de mise à niveau du programme d’installation, chaque package doit avoir une propriété UpgradeCode et une table de mise à niveau. Chaque enregistrement de la table Mise à niveau fournit une combinaison caractéristique de code de mise à niveau, de version de produit et d’informations de langue utilisées pour identifier un ensemble de produits affectés par la mise à niveau. Lorsque l’action FindRelatedProducts détecte un produit affecté installé sur le système, il ajoute le code de produit à une propriété spécifiée dans la colonne ActionProperty. L’action RemoveExistingProducts et l’action MigrateFeatureStates supprime uniquement ou migre les produits répertoriés dans la colonne ActionProperty.
Le tableau De mise à niveau contient les colonnes indiquées dans le tableau suivant.
| Colonne | Type | Clé | Nullable |
|---|---|---|---|
| UpgradeCode | GUID | Y | N |
| VersionMin | texte | Y | Y |
| VersionMax | texte | Y | Y |
| Langue | texte | Y | Y |
| Attributs | entier | Y | N |
| Enlever | mise en forme | N | Y |
| ActionProperty | identificateur | N | N |
Colonnes
-
UpgradeCode
-
La propriété UpgradeCode de cette colonne spécifie le code de mise à niveau de tous les produits à détecter par l’action FindRelatedProducts.
-
versionMin
-
Limite inférieure de la plage de versions de produit détectées par FindRelatedProducts. Entrez msidbUpgradeAttributesVersionMinInclusive dans Les 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 est null, FindRelatedProducts ignore msidbUpgradeAttributesVersionMinInclusive et détecte toutes les versions précédentes. VersionMin et VersionMax ne doivent pas tous les deux ê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
-
Limite supérieure de la plage de versions de produit détectée par l’action FindRelatedProducts. Entrez msidbUpgradeAttributesVersionMaxInclusive dans Attributs pour inclure VersionMax dans la plage. Si VersionMax est une chaîne vide (« »), elle est évaluée de la même façon que 0. Si VersionMax est 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 tous les deux ê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ées par FindRelatedProducts. Entrez une liste d’identificateurs de langue numérique (LANGID) séparés par des virgules. Entrez msidbUpgradeAttributesLanguagesExclusive dans Attributes pour détecter toutes les langues exclusives de celles répertoriées dans Language. Si la langue est 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 Décimal Hexadécimal 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 les supprime pas. msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Continue l’installation en cas d’échec de 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 1024 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 de mise en forme mise en forme entrée dans ce champ doit être évaluée à une liste délimitée par des virgules des noms de fonctionnalités. Par exemple : [Feature1],[Feature2],[Feature3]. Aucune fonctionnalité n’est supprimée si le champ contient du texte mis en forme qui prend la valeur d’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’action FindRelatedProducts détecte un produit associé installé sur le système, il 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 un code de produit de liste, séparé par des points-virgules (;), détectés sur le système.
Validation