<installchecks>Elemento (ClickOnce Bootstrapper)

The 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 ClickOnce aplicativo foram 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
        File
        SearchDepth
    />
</InstallChecks>

AssemblyCheck

Este elemento é 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 de um teste sob o InstallConditions elemento, que é um filho das Command elemento. Para obter mais informações, consulte <commands>Elemento (ClickOnce Bootstrapper).
Name	Obrigatório. O nome totalmente qualificado do assembly para verificar.
PublicKeyToken	Obrigatório. Forma abreviada de chave pública associado a este assembly de nome seguro. Todos os módulos (assemblies) armazenados no GAC deve ter um nome, uma versão e uma chave pública.
Version	Obrigatório. Versão do assembly. O número de versão tem o formato <versão principal>.<versão secundária>.<criar versão>.<versão de revisão>.
Language	Opcional. O linguagem de um assembly localizado. O padrão é neutro.
ProcessorArchitecture	Opcional. O processador do computador alvo por esta instalação. O padrão é MSIL.

ExternalCheck

Este elemento é 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 armazene seu código de sair na propriedade indicada por Property. ExternalCheck é útil para a implementação de verificações de dependência complexos ou quando a única maneira de verificar a existência de um componente é instanciar ele.

ExternalCheck 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 de um teste sob o InstallConditions elemento, que é um filho das Command elemento. Para obter mais informações, consulte <commands>Elemento (ClickOnce Bootstrapper).
PackageFile	Obrigatório. O programa externo para executar. O programa deve ser parte do pacote de distribuição de instalação.
Arguments	Opcional. Fontes de argumentos de linha de comando para o executável nomeado por PackageFile.

FileCheck

Este elemento é um elemento filho opcional de InstallChecks. Para cada instância de FileCheck, o bootstrapper determinará se o arquivo nomeado existe e retorna 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 nomeada por Property como 0. Se o arquivo não existir, Property não é conjunto para qualquer valor.

FileCheck 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 de um teste sob o InstallConditions elemento, que é um filho das Command elemento. Para obter mais informações, consulte <commands>Elemento (ClickOnce Bootstrapper).
FileName	Obrigatório. O nome do arquivo para encontrar.
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 Windows ou ClickOnce. O padrão é interpretar SearchPath sistema autônomo um caminho absoluto. Os valores válido incluem o seguinte: AppDataFolder. A pasta de dados de aplicativo para este ClickOnce aplicativo; específicas ao usuário corrente. CommonAppDataFolder. Pasta de dados do aplicativo utilizada por todos os usuários. CommonFilesFolder. A pasta arquivos comuns para o usuário corrente. LocalDataAppFolder. A pasta dados de aplicativos roaming não. ProgramFilesFolder. A pasta arquivos de programa padrão para aplicativos de 32 bit. StartUpFolder. A pasta que contém todos os aplicativos iniciados na inicialização do sistema. SystemFolder. A pasta que contém as DLLs do sistema de 32 bit. WindowsFolder. A pasta que contém a instalação do sistema Windows. WindowsVolume. A unidade ou partição que contém a instalação do sistema Windows.
SearchDepth	Opcional. A profundidade na qual se deseja pesquisar subpastas para o arquivo nomeado. A Pesquisar é primeiro de profundidade. O padrão é 0, o que restringe a Pesquisar para a pasta de nível superior especificada por SpecialFolder e SearchPath.

MsiProductCheck

Este elemento é um elemento filho opcional de InstallChecks. Para cada instância de MsiProductCheck, o bootstrapper verifica se a instalação do Microsoft Windows Installer especificada 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 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 estiver instalado no computador, Property não é conjunto.

MsiProductCheck 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 de um teste sob o InstallConditions elemento, que é um filho das Command elemento. Para obter mais informações, consulte <commands>Elemento (ClickOnce Bootstrapper).
Product	Obrigatório. O GUID para o produto instalado.
Feature	Opcional. O GUID de um recurso específico do aplicativo instalado.

RegistryCheck

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

RegistryCheck 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 de um teste sob o InstallConditions elemento, que é um filho das Command elemento. Para obter mais informações, consulte <commands>Elemento (ClickOnce Bootstrapper).
Key	Obrigatório. O nome da chave do registro.
Value	Opcional. O nome do valor do registro para recuperar. O padrão é retornar o texto do valor padrão. Value deve ser um String ou uma DWORD.

RegistryFileCheck

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

RegistryFileCheck 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 de um teste sob o InstallConditions elemento, que é um filho das Command elemento. Para obter mais informações, consulte <commands>Elemento (ClickOnce Bootstrapper).
Key	Obrigatório. O nome da chave do registro. Seu valor é interpretado sistema autônomo o caminho para um arquivo, a menos que o File o atributo é conjunto. Se esta chave não existir, Property não foi definida.
Value	Opcional. O nome do valor do registro para recuperar. O padrão é retornar o texto do valor padrão. Value deve ser um String.
File	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, o valor retornado do registro será considerado o caminho completo para um arquivo.
SearchDepth	Opcional. A profundidade na qual se deseja pesquisar subpastas para o arquivo nomeado. A Pesquisar é primeiro de profundidade. O padrão é 0, o que restringe a Pesquisar para a pasta de nível superior especificada pelo valor da chave do registro.

Comentários

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

Exemplo

O exemplo de código a seguir demonstra o InstallChecks elemento sistema autônomo 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, que produzem propriedades. As propriedades são usadas por InstallConditions para determinar se um pacote deve instalar, ignorar ou falhar. A tabela a seguir lista o InstallConditions:

InstallIf	All InstallIf condições devem ser avaliada como true para instalar o componente. Se um ou mais de InstallIf avaliar as condições para false, o componente será ignorado. Não há outras condições serão avaliadas.
FailIf	Se qualquer FailIf condição for avaliada como true, o pacote falhará. O restante das condições não será avaliado. O pacote falhará mesmo se um ou mais InstallIf as verificações são verdadeiras.
BypassIf	Se qualquer BypassIf condição for avaliada como true, o pacote será ignorado. O restante das condições não será avaliado. O pacote será ignorado, mesmo se um ou mais InstallIf as verificações são verdadeiras.

Propriedades predefinidas

O bootstrapper automaticamente irá definir as seguintes propriedades para uso por InstallIfA seguinte tabela lista o BypassIf e FailIf elementos:

Propriedade	Anotações	Valores possíveis
Version9X	Número de versão do sistema operacional Windows 9 X.	4.10 = Windows 98
VersionNT	Número de um sistema operacional Windows NT versão.	Major.Minor.ServicePack 5,0 = Windows 2000 5.1.0 = Windows XP 5.1.2 = Windows XP Professional SP2 5.2.0 = Windows servidor 2003
VersionNT64	Número de versão de um sistema de operacional 64 bit baseados no Windows NT.	O mesmo sistema autônomo 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 baseado no Windows NT.	0 = sem privilégios de administrador 1 = privilégios de administrador

Por exemplo, para bloquear a instalação em um computador com Windows 95, use o código sistema autônomo o seguinte:

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

Consulte também

Referência

<commands>Elemento (ClickOnce Bootstrapper)

Produto e referência do esquema do pacote

Last updated on 2010-08-25

Partilhar via