<InstallChecks> Elemento (Bootstrapper)

O InstallChecks elemento oferece suporte ao início de uma variedade de testes no computador local para certificar-se de que todos os pré-requisitos adequados para um aplicativo foi instalados.

<InstallChecks>
    <AssemblyCheck 
        Property
        Name
        PublicKeyToken
        Version
        Language
        ProcessorArchitecture
    />
    <RegistryCheck
        Property
        Key
        Value
    />
    <ExternalCheck 
        PackageFile
        Property
        Arguments
    />
    <FileCheck 
        Property
        FileName
        SearchPath
        SpecialFolder
        SearchDepth
    />
    <MsiProductCheck 
        Property
        Product
        Feature
    />
    <RegistryFileCheck 
        Property
        Key
        Value
        FileName
        SearchDepth
    />
</InstallChecks>

AssemblyCheck

Este é um elemento filho opcional de InstallChecks. Para cada instância de AssemblyCheck, o bootstrapper irá se certificar que o assembly identificado pelo elemento existe no cache global de assemblies (GAC). Ele não contém elementos e tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para armazenar o resultado. Esta propriedade pode ser referenciada a partir de um teste sob o InstallConditions elemento, que é filho da Command elemento. Para obter mais informações, consulte <Commands> Elemento (Bootstrapper).
Name	Obrigatório. O nome totalmente qualificado do assembly para verificar.
PublicKeyToken	Obrigatório. A forma abreviada da chave pública associado a este assembly de nome de alta segurança. Todos os módulos (assemblies) armazenados no GAC deve ter um nome, uma versão e uma chave pública.
Version	Obrigatório. A versão do assembly. O número de versão tem o formato <versão principal>. <versão secundária>. <criar versão>. <a versão de revisão>.
Language	Opcional. O idioma de um assembly localizado. O padrão é neutra.
ProcessorArchitecture	Opcional. O processador do computador alvo por esta instalação. O padrão é msil.

ExternalCheck

Este é um elemento filho opcional de InstallChecks. Para cada instância de ExternalCheck, o bootstrapper irá executar o programa externo nomeado em um processo separado e armazenar seu código de saída na propriedade indicada por Property. ExternalChecké útil para implementar as verificações de dependência complexos ou quando a única maneira de verificar a existência de um componente é para instanciá-la.

ExternalChecknão contém elementos e tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para armazenar o resultado. Esta propriedade pode ser referenciada a partir de um teste sob o InstallConditions elemento, que é filho da Command elemento. Para obter mais informações, consulte <Commands> Elemento (Bootstrapper).
PackageFile	Obrigatório. O programa externo para executar. O programa deve ser parte do pacote de distribuição do programa de instalação.
Arguments	Opcional. Fornece os argumentos de linha de comando para o executável nomeado por PackageFile.

FileCheck

Este é um elemento filho opcional de InstallChecks. Para cada instância de FileCheck, o bootstrapper determinará se o arquivo nomeado existe e retornar o número de versão do arquivo. Se o arquivo não tiver um número de versão, o bootstrapper define a propriedade denominada por Property como 0. Se o arquivo não existir, Property não está definido como qualquer valor.

FileChecknão contém elementos e tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para armazenar o resultado. Esta propriedade pode ser referenciada a partir de um teste sob o InstallConditions elemento, que é filho da Command elemento. Para obter mais informações, consulte <Commands> Elemento (Bootstrapper).
FileName	Obrigatório. O nome do arquivo para localizar.
SearchPath	Obrigatório. O disco ou pasta na qual deseja procurar o arquivo. Deve ser um caminho relativo se SpecialFolder é atribuído; Caso contrário, ele deve ser um caminho absoluto.
SpecialFolder	Opcional. Uma pasta que tem significado especial para o Windows ou para ClickOnce. O padrão é interpretar SearchPath como um caminho absoluto Os valores válidos incluem o seguinte: AppDataFolder. A pasta de dados do aplicativo para este ClickOnce aplicativo; específico para o usuário atual. CommonAppDataFolder. A pasta de dados do aplicativo usada por todos os usuários. CommonFilesFolder. A pasta de arquivos comuns para o usuário atual. LocalDataAppFolder. A pasta de dados para aplicativos móveis não. ProgramFilesFolder. A pasta de arquivos de programa padrão para aplicativos de 32 bits. StartUpFolder. A pasta que contém todos os aplicativos iniciados na inicialização do sistema. SystemFolder. A pasta que contém as DLLs de sistema de 32 bits. WindowsFolder. A pasta que contém a instalação de sistema do Windows. WindowsVolume. A unidade ou partição que contém a instalação de sistema do Windows.
SearchDepth	Opcional. A profundidade na qual Pesquisar subpastas para um arquivo nomeado. A pesquisa é o primeiro de profundidade. O padrão é 0, o que restringe a pesquisa para a pasta de nível superior especificada por SpecialFolder e SearchPath.

MsiProductCheck

Este é um elemento filho opcional de InstallChecks. Para cada instância de MsiProductCheck, o bootstrapper verifica se a instalação de Microsoft Windows Installer especificado foi executado até que ela seja concluída. O valor da propriedade é definido, dependendo do estado do produto instalado. Um valor positivo indica que o produto está instalado, 0 ou -1 indica que ele não está instalado. (Consulte a função do SDK do Windows Installer MsiQueryFeatureState para obter mais informações). . Se o Windows Installer não está instalado no computador, Property está definido.

MsiProductChecknão contém elementos e tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para armazenar o resultado. Esta propriedade pode ser referenciada a partir de um teste sob o InstallConditions elemento, que é filho da Command elemento. Para obter mais informações, consulte <Commands> Elemento (Bootstrapper).
Product	Obrigatório. O GUID do produto instalado.
Feature	Opcional. O GUID para um recurso específico do aplicativo instalado.

RegistryCheck

Este é um elemento filho opcional de InstallChecks. Para cada instância de RegistryCheck, o bootstrapper verifica se a chave do Registro especificada existir, ou se ele tem o valor indicado.

RegistryChecknão contém elementos e tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para armazenar o resultado. Esta propriedade pode ser referenciada a partir de um teste sob o InstallConditions elemento, que é filho da Command elemento. Para obter mais informações, consulte <Commands> Elemento (Bootstrapper).
Key	Obrigatório. O nome da chave do registro.
Value	Opcional. O nome do valor do registro para recuperar. O padrão é para retornar o texto do valor padrão. Valuedeve ser uma seqüência de caracteres ou uma DWORD.

RegistryFileCheck

Este é um elemento filho opcional de InstallChecks. Para cada instância de RegistryFileCheck, o bootstrapper recupera a versão do arquivo especificado, a primeira tentativa de recuperar o caminho para o arquivo da chave do Registro especificada. Isso é particularmente útil se você quiser pesquisar um arquivo em um diretório especificado como um valor no registro.

RegistryFileChecknão contém elementos e tem os seguintes atributos.

Atributo	Descrição
Property	Obrigatório. O nome da propriedade para armazenar o resultado. Esta propriedade pode ser referenciada a partir de um teste sob o InstallConditions elemento, que é filho da Command elemento. Para obter mais informações, consulte <Commands> Elemento (Bootstrapper).
Key	Obrigatório. O nome da chave do registro. Seu valor é interpretado como o caminho para um arquivo, a menos que o File atributo está definido. Se esta chave não existir, Property está definido.
Value	Opcional. O nome do valor do registro para recuperar. O padrão é para retornar o texto do valor padrão. Valuedeve ser uma seqüência de caracteres.
FileName	Opcional. O nome de um arquivo. Se especificado, o valor obtido da chave do registro é considerado um caminho de diretório, e esse nome é acrescentado a ele. Se não for especificado, presume-se que o valor retornado do registro para ser o caminho completo para um arquivo.
SearchDepth	Opcional. A profundidade na qual Pesquisar subpastas para um arquivo nomeado. A pesquisa é o primeiro de profundidade. O padrão é 0, o que restringe a pesquisa para a pasta de nível superior especificada pelo valor da chave de registro.

Comentários

Enquanto os elementos sob InstallChecks definir testes a serem executados, eles não os execute. Para executar os testes, você deve criar Command elementos sob o Commands elemento.

Exemplo

O exemplo de código a seguir demonstra a InstallChecks elemento como ele é usado no arquivo de produto para o .NET Framework.

<InstallChecks>
    <ExternalCheck Property="DotNetInstalled" PackageFile="dotnetchk.exe" />
    <RegistryCheck Property="IEVersion" Key="HKLM\Software\Microsoft\Internet Explorer" Value="Version" />
</InstallChecks>

InstallConditions

Quando InstallChecks são avaliadas, eles produzem propriedades. As propriedades são usadas por InstallConditions para determinar se um pacote deve instalar, ignorar ou falhar. A tabela a seguir listas os InstallConditions:

FailIf	Se houver FailIf condição for avaliada como true, o pacote irá falhar. O restante das condições não será avaliado.
BypassIf	Se houver BypassIf condição for avaliada como true, o pacote será ignorado. O restante das condições não será avaliado.

Propriedades predefinidas

A tabela a seguir listas os BypassIf e FailIf elementos:

Propriedade	Anotações	Valores possíveis
Version9X	Número de versão do sistema operacional Windows 9 X.	4.10 = O Windows 98
VersionNT	Número de versão do sistema operacional baseado em Windows NT.	Major.Minor.ServicePack 5.0 = O Windows 2000 5.1.0 = O Windows XP 5.1.2 = O Windows XP Professional SP2 5.2.0 = O Windows Server 2003
VersionNT64	Número de versão de um sistema de operacional de 64 bits baseados em Windows NT.	O mesmo como mencionado anteriormente.
VersionMsi	Número de versão do serviço Windows Installer.	2.0 = Windows Installer 2.0
AdminUser	Especifica se um usuário tem privilégios de administrador em um sistema operacional do Windows NT.	0 = sem privilégios de administrador 1 = privilégios de administrador

Por exemplo, para bloquear a instalação em um computador executando o Windows 95, use o código como o seguinte:

<!-- Block install on Windows 95 -->
    <FailIf Property="Version9X" Compare="VersionLessThan" Value="4.10" String="InvalidPlatform"/>

Consulte também

Referência

<Commands> Elemento (Bootstrapper)

Product and Package Schema Reference