Formatado

O tipo de dados formatado é uma cadeia de caracteres de texto que é processada para resolver nomes de propriedades incorporadas, chaves de tabela, referências de variáveis de ambiente e outras subcadeias de caracteres especiais. As seguintes convenções são reconhecidas para resolver a cadeia de caracteres:

• Colchetes quadrados ([ ]) ou chaves ({ }) sem par correspondente são deixados no texto.

• Se uma substring do formulário [propertyname] for encontrada, ela será substituída pelo valor da propriedade. Se propertyname não for um nome de propriedade válido, a substring será resolvida como em branco. Por exemplo, a coluna Description do LaunchCondition Table usa uma cadeia de caracteres formatada. Se ERRORTXT tiver sido definido como "Entre em contato com sua equipe de suporte." o texto exibido para falhar na condição de inicialização incluirá essa cadeia de caracteres. Se ERRORTXT não estiver definido, o texto exibido para falhar na condição de inicialização seria apenas "O sistema não atende aos requisitos de instalação".

  Condição	Descrição
  Versão9X	O sistema não atende aos requisitos de instalação. [ERRORTXT]

   

• Os colchetes podem ser iterados e os nomes de propriedade são resolvidos de dentro para fora. Por exemplo, suponha que a substring [[PropertyA]] apareça no texto. Primeiro, o valor da propriedade PropertyA é recuperado. Se o valor for um nome de propriedade válido, como PropertyB, o valor de PropertyB será recuperado e toda a substring [[PropertyA]] será substituída pelo valor de PropertyB. Se PropertyA não for um nome de propriedade válido ou se o valor de PropertyA não for um nome de propriedade válido, a substring estará em branco.

• Se uma substring do formulário [%environmentvariable] for encontrada, o valor da variável de ambiente será substituído pela substring.

• Se uma substring do formulário [\x] for encontrada, ela será substituída pelo caractere x , onde x é um caractere, sem qualquer processamento adicional. Apenas o primeiro personagem após a barra invertida é mantido; tudo o resto é removido. Por exemplo, para incluir um colchete esquerdo literal ([), use [\[]. O texto [\[]Texto entre colchetes[\]] é resolvido para [Texto entre colchetes].

• Se uma substring estiver entre chaves ({ }) e não contiver nomes de propriedade entre colchetes ([ ]), a substring será deixada inalterada, incluindo as chaves encaracoladas.

• Se uma substring estiver entre chaves ({ }) e contiver um ou mais nomes de propriedade entre colchetes ([ ]), então, se todos os nomes de propriedade forem válidos, o texto (com as substituições resolvidas) será exibido sem as chaves curvas.

• Se uma substring do formulário [~] for encontrada, ela será substituída pelo caractere nulo. Isso é usado para criar cadeias de caracteres REG_MULTI_SZ na tabela Registro. Observe que [~] também é usado para acrescentar ou prefixar valores a variáveis de ambiente usando a tabela Ambiente .

• Se uma substring do formulário [#filekey] for encontrada, ela será substituída pelo caminho completo do arquivo, com o valor filekey usado como uma chave na tabela File. O valor de [#filekey] permanece em branco e não é substituído por um caminho até que o instalador execute a ação CostInitialize, ação FileCoste ação CostFinalize. O valor de [#filekey] depende do estado de instalação do componente ao qual o arquivo pertence. Se o componente for executado a partir da origem, o valor será o caminho para o local de origem do arquivo. Se o componente for executado localmente, o valor será o caminho para o local de destino do arquivo após a instalação. Se o componente tiver um estado de ação ausente, o estado instalado do componente será usado para determinar o [).

• Se uma substring do formulário [$componentkey] for encontrada, ela será substituída pelo diretório de instalação do componente, com o valor componentkey usado como uma chave na tabela Component. O valor de [$componentkey] permanece em branco e não é substituído por um diretório até que o instalador execute a ação CostInitialize, ação FileCoste ação CostFinalize. O valor de [$componentkey] depende do estado de instalação do componente e onde ele ocorre. Na coluna Valor da Tabela do Registro, essa substring pode se referir ao estado da ação ou ao estado da ação solicitada do componente. Em todos os outros casos, essa substring refere-se ao estado de ação do componente. Por exemplo, se o componente for executado a partir da origem, o valor será o diretório de origem do arquivo. Se o componente for executado localmente, o valor será o diretório de destino após a instalação. Se o componente estiver ausente, o valor será deixado em branco. O Windows Installer rastreia a ação e os estados de instalação solicitados dos componentes. Por exemplo, se um componente já estiver instalado, ele pode ter um estado solicitado de local e um estado de ação nulo. Para obter mais informações sobre como verificar o estado de instalação dos componentes, consulte Verificando a instalação de recursos, componentes, arquivos.

• Observe que, se um componente já estiver instalado e não for reinstalado, removido ou movido durante a instalação atual, o estado de ação do componente será nulo e a cadeia de caracteres [$componentkey] será avaliada como Nulo.

• Se uma substring do formulário [!filekey] for encontrada, ela será substituída pelo caminho curto completo do arquivo, com o valor filekey usado como uma chave na tabela File.

  Essa sintaxe é válida somente quando usada na coluna Valor das tabelas Registro ou IniFile. Quando usada em outras colunas, essa sintaxe é tratada da mesma forma que [#filekey] .