<deployment> Elemento (implantação de ClickOnce)
Identifica os atributos usados para a implantação de atualizações e exposição ao sistema.
<deployment
install
minimumRequiredVersion
mapFileExtensions
disallowUrlActivation
trustUrlParameters
>
<subscription>
<update>
<beforeApplicationStartup/>
<expiration
maximumAge
unit
/>
</update>
</subscription>
<deploymentProvider
codebase
/>
</deployment>
Elementos e atributos
O deployment elemento é obrigatório e está sendo o urn:schemas-microsoft-com:asm.v1 espaço para nome.O elemento tem os seguintes atributos.
Atributo |
Descrição |
|---|---|
install |
Obrigatório.Especifica se este aplicativo define uma presença no Windows Iniciar menu e, no painel de controle Adicionar ou remover programas aplicativo.Os valores válidos são true e false.Se false, ClickOnce sempre será executado a versão mais recente deste aplicativo da rede e não reconhecerá a subscription elemento. |
minimumRequiredVersion |
Opcional.Especifica a versão mínima deste aplicativo que pode ser executado no cliente.Se o número da versão do aplicativo for menor que o número de versão fornecido no manifesto de implantação, o aplicativo não será executado.Números de versão devem ser especificados no formato n.n.n. n, onde n é um inteiro não assinado.Se a install atributo é false, minimumRequiredVersion não deve ser definido. |
mapFileExtensions |
Opcional.O padrão false.Se true, todos os arquivos na implantação devem ter uma extensão. Deploy.ClickOnceirá remover esta extensão esses arquivos, assim que ele baixa essas atualizações do servidor Web.Se você publicar seu aplicativo usando Visual Studio, adiciona automaticamente essa extensão a todos os arquivos.Este parâmetro permite que todos os arquivos dentro de um ClickOnce a implantação seja baixado de um servidor Web que bloqueia a transmissão de arquivos que terminam em "não seguras" extensões como. exe. |
disallowUrlActivation |
Opcional.O padrão false.Se true, impede que um aplicativo instalado que está sendo iniciado clicando no URL ou digitando a URL no Internet Explorer.Se a install atributo não estiver presente, esse atributo é ignorado. |
trustURLParameters |
Opcional.O padrão false.Se true, permite que a URL conter os parâmetros de seqüência de caracteres de consulta que são passados para o aplicativo, bem como argumentos de linha de comando são passados para um aplicativo de linha de comando.Para obter mais informações, consulte Como: recuperar informações de seqüência de caracteres de consulta em um aplicativo on-line ClickOnce. Se a disallowUrlActivation atributo é true, trustUrlParameters deve ser excluído do manifesto, ou explicitamente definido como false. |
O deployment elemento também contém os seguintes elementos filho.
assinatura
Opcional.Contém o update elemento.O subscription elemento não tem nenhum atributo.Se a subscription elemento não existir, o ClickOnce aplicativo nunca irá procurar por atualizações disponíveis.Se a install atributo da deployment elemento é false, o subscription elemento é ignorado, pois um ClickOnce aplicativo é iniciado a partir da rede sempre usa a versão mais recente.
atualizar
Obrigatório.Este elemento é filho da subscription elemento e contenha o beforeApplicationStartup ou o expiration elemento.beforeApplicationStartupe expiration não pode ser especificados no manifesto de implantação do mesmo.
O update elemento não tem nenhum atributo.
beforeApplicationStartup
Opcional.Este elemento é filho de update elemento e sem atributos.Quando o beforeApplicationStartup elemento existe, o aplicativo será bloqueado quando ClickOnce verifica se há atualizações, se o cliente estiver on-line.Se esse elemento não existir, ClickOnce primeiro fará uma busca de atualizações de acordo com os valores especificados para o expiration elemento.beforeApplicationStartupe expiration não pode ser especificados no manifesto de implantação do mesmo.
expiração
Opcional.Este elemento é filho de update elemento, e não tem filhos.beforeApplicationStartupe expiration não pode ser especificados no manifesto de implantação do mesmo.Quando a verificação de atualização ocorre e uma versão atualizada é detectada, a nova versão armazena em cache enquanto a versão existente é executado.A nova versão, em seguida, instala no lançamento da próximo a ClickOnce aplicativo.
O expiration elemento suporta os seguintes atributos.
Atributo |
Descrição |
|---|---|
maximumAge |
Obrigatório.Identifica a antiga como a atualização atual deve se tornar antes que o aplicativo executa uma verificação de atualização.A unidade de tempo é determinada pelo unit atributo. |
unit |
Obrigatório.Identifica a unidade de tempo para maximumAge.Unidades válidas são horas, dias, e semanas. |
deploymentProvider
Para o.NET Framework 2.0, esse elemento é necessário se o manifesto de implantação contém um subscription seção.Para o.NET Framework 3.5 e posterior, esse elemento é opcional e o padrão será o servidor e caminho do arquivo no qual o manifesto de implantação foi descoberto.
Este elemento é filho de deployment elemento e tem o atributo a seguir.
Atributo |
Descrição |
|---|---|
codebase |
Obrigatório.Identifica o local, como um identificador de URI (Uniform Resource), de que o manifesto de implantação é usado para atualizar o ClickOnce aplicativo.Esse elemento também permite o encaminhamento de locais de atualização para instalações baseadas em CD.Deve ser um URI válido. |
Comentários
Você pode configurar seu ClickOnce procurar atualizações após a inicialização do aplicativo para verificar se há atualizações na inicialização, ou nunca verificar atualizações.Para verificar se há atualizações na inicialização, certifique-se que o beforeApplicationStartup elemento existe sob o update elemento.Para verificar se há atualizações após a inicialização, certifique-se que o expiration elemento existe sob o update elemento e que os intervalos de atualização são fornecidos.
Para desabilitar a verificação de atualizações, remova o subscription elemento.Quando você especifica no manifesto de implantação para nunca verificar se há atualizações, você pode ainda verificar as atualizações manualmente, usando o CheckForUpdate método.
Para obter mais informações sobre como o deploymentProvider está relacionado a atualizações, consulte Escolhendo uma estratégia de atualização de ClickOnce.
Exemplos
O exemplo de código a seguir ilustra uma deployment elemento em um ClickOnce o manifesto de implantação.O exemplo usa um deploymentProvider elemento para indicar o local preferido de atualização.
<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
<subscription>
<update>
<expiration maximumAge="6" unit="hours" />
</update>
</subscription>
<deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
</deployment>