Tabela de atualização
A tabela Atualizar contém informações necessárias durante principais atualizações. Para habilitar totalmente os recursos de atualização do instalador, cada pacote deve ter uma propriedade UpgradeCode e uma tabela Upgrade. Cada registro na tabela Upgrade fornece uma combinação característica de código de atualização, versão do produto e informações de idioma usadas para identificar um conjunto de produtos afetados pela atualização. Quando a ação FindRelatedProducts deteta um produto afetado instalado no sistema, ela acrescenta o código do produto a uma propriedade especificada na coluna ActionProperty. A ação RemoveExistingProducts e a ação MigrateFeatureStates removem ou migram apenas produtos listados na coluna ActionProperty.
A tabela Atualizar contém as colunas mostradas na tabela a seguir.
| Coluna | Tipo | Chave | Nulo |
|---|---|---|---|
| Código de atualização | GUID | Y | N |
| VersãoMin | de texto | Y | Y |
| VersãoMax | de texto | Y | Y |
| Idioma | de texto | Y | Y |
| Atributos | inteiro | Y | N |
| Remover | Formatado | N | Y |
| ActionProperty | Identificador | N | N |
Colunas
-
UpgradeCode
-
A propriedade UpgradeCode nesta coluna especifica o código de atualização de todos os produtos que devem ser detetados pela ação FindRelatedProducts.
-
VersionMin
-
Limite inferior da gama de versões de produtos detetados por FindRelatedProducts. Insira msidbUpgradeAttributesVersionMinInclusive em Atributos para incluir VersionMin no intervalo. Se VersionMin for igual a uma string vazia ("") ela será avaliada da mesma forma que 0. Se VersionMin for null, FindRelatedProducts ignorará msidbUpgradeAttributesVersionMinInclusive e detetará todas as versões anteriores. VersionMin e VersionMax não devem ser ambos nulos.
VersionMin deve ser uma versão válida do produto, conforme descrito para a propriedadeProductVersion. Observe que o Windows Installer usa apenas os três primeiros campos da versão do produto. Se você incluir um quarto campo na versão do produto, o instalador ignorará o quarto campo.
-
VersionMax
-
Limite superior da gama de versões de produtos detetada pela ação FindRelatedProducts. Insira msidbUpgradeAttributesVersionMaxInclusive em Atributos para incluir VersionMax no intervalo. Se VersionMax for uma string vazia (""), ela será avaliada da mesma forma que 0. Se VersionMax for null, FindRelatedProducts ignorará msidbUpgradeAttributesVersionMaxInclusive e detetará todas as versões do produto maiores que (ou maiores ou iguais a) o limite inferior especificado por VersionMin e msidbUpgradeAttributesVersionMinInclusive. VersionMin e VersionMax não devem ser ambos nulos.
VersionMax deve ser uma versão válida do produto, conforme descrito para a propriedade ProductVersion. Observe que o Windows Installer usa apenas os três primeiros campos da versão do produto. Se você incluir um quarto campo na versão do produto, o instalador ignorará o quarto campo.
-
Língua
-
O conjunto de idiomas detetados pelo FindRelatedProducts. Insira uma lista de identificadores numéricos de idioma (LANGID) separados por vírgulas. Digite msidbUpgradeAttributesLanguagesExclusive em Atributos para detetar todos os idiomas exclusivos daqueles listados em Idioma. Se Language for null ou uma string vazia (""), FindRelatedProducts ignorará msidbUpgradeAttributesLanguagesExclusive e detetará todos os idiomas.
-
Atributos
-
Esta coluna contém sinalizadores de bits especificando atributos da tabela Upgrade.
-
Remover
-
O instalador define a propriedade REMOVE como recursos especificados nesta coluna. Os recursos a serem removidos podem ser determinados em tempo de execução. A cadeia de caracteres Formatado inserida neste campo deve ser avaliada de acordo com uma lista delimitada por vírgulas de nomes de recursos. Por exemplo: [Feature1],[Feature2],[Feature3]. Nenhum recurso será removido se o campo contiver texto formatado avaliado como uma cadeia de caracteres vazia (""). O instalador define REMOVE=ALL somente se o campo Remover estiver vazio. Observe a diferença entre uma cadeia de caracteres vazia e um campo vazio. Se o campo estiver vazio, é nulo.
-
ActionProperty
-
Quando a ação FindRelatedProducts deteta um produto relacionado instalado no sistema, ela acrescenta o código do produto à propriedade especificada neste campo. A propriedade especificada nesta coluna deve ser uma propriedade pública e o autor do pacote deve adicionar a propriedade à propriedadeSecureCustomProperties. Cada linha na tabela Upgrade deve ter um valor ActionProperty exclusivo. Depois de FindRelatedProducts, o valor dessa propriedade é uma lista de códigos de produto, separados por ponto-e-vírgula (;), detetados no sistema.
Validação