Uppgradera tabell
Tabellen Uppgradera innehåller information som krävs under större uppgraderingar. För att fullständigt aktivera installationsprogrammets uppgraderingsfunktioner bör varje paket ha en UpgradeCode--egenskap och en uppgraderingstabell. Varje post i tabellen Uppgradering ger en karakteristisk kombination av uppgraderingskod, produktversion och språkinformation som används för att identifiera en uppsättning produkter som påverkas av uppgraderingen. När åtgärden FindRelatedProducts identifierar en påverkad produkt som är installerad i systemet lägger den till produktkoden i en egenskap som anges i kolumnen ActionProperty. Åtgärden RemoveExistingProducts och åtgärden MigrateFeatureStates endast ta bort eller migrera produkter som anges i kolumnen ActionProperty.
Tabellen Uppgradera innehåller de kolumner som visas i följande tabell.
| Spalt | Typ | Nyckel | Nullbar |
|---|---|---|---|
| UpgradeCode | GUID- | Y | N |
| VersionMin | Text | Y | Y |
| VersionMax | Text | Y | Y |
| Språk | Text | Y | Y |
| Attribut | Heltal | Y | N |
| Avlägsna | formaterad | N | Y |
| ActionProperty | identifierare | N | N |
Kolumner
-
UpgradeCode
-
Egenskapen UpgradeCode i den här kolumnen anger uppgraderingskoden för alla produkter som ska identifieras av åtgärden FindRelatedProducts.
-
VersionMin
-
Lägre gräns för produktversioner som identifierats av FindRelatedProducts. Ange msidbUpgradeAttributesVersionMinInclusive i Attribut för att inkludera VersionMin i intervallet. Om VersionMin är lika med en tom sträng ("") utvärderas den på samma sätt som 0. Om VersionMin är null ignorerar FindRelatedProducts msidbUpgradeAttributesVersionMinInclusive och identifierar alla tidigare versioner. Både VersionMin och VersionMax får inte vara null.
VersionMin måste vara en giltig produktversion enligt beskrivningen för egenskapen ProductVersion. Observera att Windows Installer endast använder de tre första fälten i produktversionen. Om du inkluderar ett fjärde fält i produktversionen ignorerar installationsprogrammet det fjärde fältet.
-
VersionMax
-
Den övre gränsen för de produktversioner som identifieras av åtgärden FindRelatedProducts. Ange msidbUpgradeAttributesVersionMaxInclusive i Attribut för att inkludera VersionMax i intervallet. Om VersionMax är en tom sträng (") utvärderas den på samma sätt som 0. Om VersionMax är null ignorerar FindRelatedProducts msidbUpgradeAttributesVersionMaxInclusive och identifierar alla produktversioner som är större än (eller större än eller lika med) den nedre gränsen som anges av VersionMin och msidbUpgradeAttributesVersionMinInclusive. Både VersionMin och VersionMax får inte vara null.
VersionMax måste vara en giltig produktversion enligt beskrivningen för egenskapen ProductVersion. Observera att Windows Installer endast använder de tre första fälten i produktversionen. Om du inkluderar ett fjärde fält i produktversionen ignorerar installationsprogrammet det fjärde fältet.
-
språk
-
Den uppsättning språk som identifieras av FindRelatedProducts. Ange en lista över numeriska språkidentifierare (LANGID) avgränsade med kommatecken. Ange msidbUpgradeAttributesLanguagesExclusive i Attribut för att identifiera alla språk som är exklusiva för de som anges i Språk. Om Language är null eller en tom sträng (""), ignorerar FindRelatedProducts msidbUpgradeAttributesLanguagesExclusive och identifierar alla språk.
-
attribut
-
Den här kolumnen innehåller bitflaggor som anger attribut för tabellen Uppgradera.
Namn på bitflagga Decimal Hexadecimal Attribut msidbUpgradeAttributesMigrateFeatures 1 0x001 Migrerar funktionstillstånd genom att aktivera logiken i åtgärden MigrateFeatureStates. msidbUpgradeAttributesOnlyDetect 2 0x002 Identifierar produkter och program men tar inte bort. msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Fortsätter installationen när det inte går att ta bort en produkt eller ett program. msidbUpgradeAttributesVersionMinInclusive 256 0x100 Identifierar versionsintervallet, inklusive värdet i VersionMin. msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Identifierar versionsintervallet, inklusive värdet i VersionMax. msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Identifierar alla språk, exklusive de språk som anges i kolumnen Språk. -
Ta bort
-
Installationsprogrammet anger egenskapen REMOVE till funktioner som anges i den här kolumnen. Vilka funktioner som ska tas bort kan fastställas vid körning. Den formaterad sträng som anges i det här fältet måste utvärderas till en kommaavgränsad lista med funktionsnamn. Till exempel: [Feature1],[Feature2],[Feature3]. Inga funktioner tas bort om fältet innehåller formaterad text som utvärderas till en tom sträng (""). Installationsprogrammet anger REMOVE=ALL endast om fältet Ta bort är tomt. Observera skillnaden mellan en tom sträng och ett tomt fält. Om fältet är tomt är det null.
-
ActionProperty
-
När åtgärden FindRelatedProducts identifierar en relaterad produkt som är installerad i systemet lägger den till produktkoden i egenskapen som anges i det här fältet. Egenskapen som anges i den här kolumnen måste vara en offentlig egenskap och paketförfattaren måste lägga till egenskapen i egenskapen SecureCustomProperties. Varje rad i tabellen Uppgradering måste ha ett unikt ActionProperty-värde. Efter FindRelatedProducts är värdet för den här egenskapen en lista över produktkoder, avgränsade med semikolon (;), identifierade i systemet.
Validering