Aggiorna tabella
La tabella Upgrade contiene informazioni necessarie durante gli aggiornamenti principali. Per abilitare completamente le funzionalità di aggiornamento del programma di installazione, ogni pacchetto deve avere una proprietà UpgradeCode e una tabella Upgrade. Ogni record nella tabella Upgrade fornisce una combinazione caratteristica di codice di aggiornamento, versione del prodotto e informazioni sulla lingua usate per identificare un set di prodotti interessati dall'aggiornamento. Quando l'azione FindRelatedProducts rileva un prodotto interessato installato nel sistema, aggiunge il codice prodotto a una proprietà specificata nella colonna ActionProperty. L'azione RemoveExistingProducts e l'azione MigrateFeatureStates consentono di rimuovere o migrare solo i prodotti elencati nella colonna ActionProperty.
La tabella Upgrade contiene le colonne illustrate nella tabella seguente.
| Colonna | Tipo | Chiave | Nullable |
|---|---|---|---|
| UpgradeCode | GUID | S | N |
| VersionMin | Text | S | S |
| VersionMax | Text | S | S |
| Linguaggio | Text | S | S |
| Attributi | Integer | S | N |
| Rimuovi | Formattato | N | S |
| ActionProperty | Identificatore | N | N |
Colonne
-
UpgradeCode
-
La proprietà UpgradeCode in questa colonna specifica il codice di aggiornamento di tutti i prodotti che devono essere rilevati dall'azione FindRelatedProducts .
-
VersionMin
-
Limite inferiore dell'intervallo di versioni del prodotto rilevate da FindRelatedProducts. Immettere msidbUpgradeAttributesVersionMinInclusive in Attributi per includere VersionMin nell'intervallo. Se VersionMin è uguale a una stringa vuota ("") viene valutata come 0. Se VersionMin è null, FindRelatedProducts ignora msidbUpgradeAttributesVersionMinInclusive e rileva tutte le versioni precedenti. VersionMin e VersionMax non devono essere entrambi null.
VersionMin deve essere una versione del prodotto valida, come descritto per la proprietà ProductVersion . Si noti che Windows Installer usa solo i primi tre campi della versione del prodotto. Se si include un quarto campo nella versione del prodotto, il programma di installazione ignora il quarto campo.
-
VersionMax
-
Limite superiore dell'intervallo di versioni del prodotto rilevate dall'azione FindRelatedProducts . Immettere msidbUpgradeAttributesVersionMaxInclusive in Attributi per includere VersionMax nell'intervallo. Se VersionMax è una stringa vuota (""), viene valutata come 0. Se VersionMax è null, FindRelatedProducts ignora msidbUpgradeAttributesVersionMaxInclusive e rileva tutte le versioni del prodotto maggiori di (o maggiore o uguale a) il limite inferiore specificato da VersionMin e msidbUpgradeAttributesVersionMinInclusive. VersionMin e VersionMax non devono essere entrambi null.
VersionMax deve essere una versione del prodotto valida, come descritto per la proprietà ProductVersion . Si noti che Windows Installer usa solo i primi tre campi della versione del prodotto. Se si include un quarto campo nella versione del prodotto, il programma di installazione ignora il quarto campo.
-
Lingua
-
Set di lingue rilevate da FindRelatedProducts. Immettere un elenco di identificatori di lingua numerici (LANGID) separati da virgole. Immettere msidbUpgradeAttributesLanguagesExclusive in Attributi per rilevare tutte le lingue esclusive di quelle elencate in Lingua. Se Language è null o una stringa vuota (""), FindRelatedProducts ignora msidbUpgradeAttributesLanguagesExclusive e rileva tutte le lingue.
-
Attributi
-
Questa colonna contiene flag di bit che specificano gli attributi della tabella Upgrade.
Nome del flag di bit Decimal Valore esadecimale Attributo msidbUpgradeAttributesMigrateFeatures 1 0x001 Esegue la migrazione degli stati delle funzionalità abilitando la logica nell'azione MigrateFeatureStates . msidbUpgradeAttributesOnlyDetect 2 0x002 Rileva prodotti e applicazioni, ma non rimuove. msidbUpgradeAttributesIgnoreRemoveFailure 4 0x004 Continua l'installazione in caso di mancata rimozione di un prodotto o di un'applicazione. msidbUpgradeAttributesVersionMinInclusive 256 0x100 Rileva l'intervallo di versioni, incluso il valore in VersionMin. msidbUpgradeAttributesVersionMaxInclusive 512 0x200 Rileva l'intervallo di versioni, incluso il valore in VersionMax. msidbUpgradeAttributesLanguagesExclusive 1024 0x400 Rileva tutte le lingue, escluse le lingue elencate nella colonna Lingua. -
Rimuovere
-
Il programma di installazione imposta la proprietà REMOVE sulle funzionalità specificate in questa colonna. Le funzionalità da rimuovere possono essere determinate in fase di esecuzione. La stringa formattata immessa in questo campo deve valutare un elenco delimitato da virgole di nomi di funzionalità. Ad esempio: [Feature1],[Feature2],[Feature3]. Nessuna funzionalità viene rimossa se il campo contiene testo formattato che restituisce una stringa vuota (""). Il programma di installazione imposta REMOVE=ALL solo se il campo Remove è vuoto. Si noti la differenza tra una stringa vuota e un campo vuoto. Se il campo è vuoto, è Null.
-
ActionProperty
-
Quando l'azione FindRelatedProducts rileva un prodotto correlato installato nel sistema, aggiunge il codice prodotto alla proprietà specificata in questo campo. La proprietà specificata in questa colonna deve essere una proprietà pubblica e l'autore del pacchetto deve aggiungere la proprietà alla proprietà SecureCustomProperties . Ogni riga nella tabella Aggiorna deve avere un valore ActionProperty univoco. Dopo FindRelatedProducts, il valore di questa proprietà è un codice prodotto elenco, separato da punti e virgola (;), rilevato nel sistema.
Convalida