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