Partilhar via


<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

The deployment elemento é obrigatório e está no asmv2namespace. O elemento tem os seguintes atributos.

Atributo

Descrição

Install

Obrigatório. Especifica se este aplicativo define uma presença on a Windows Iniciar menu e no painel de controle Adicionar ou remover programas aplicativo. Os valores válido são True and False. If False, ClickOnce sempre será executado a versão mais recente do aplicativo da rede e não reconhecerá o subscription elemento.

minimumRequiredVersion

Opcional. Especifica a versão mínima do aplicativo que pode ser executados no cliente. Se o número de versão do aplicativo for menor do que o número de versão fornecido com o manifesto de implantação, o aplicativo não será executado. Números de versão devem ser especificados no formato N.N.N.N, where N é um inteiro sem sinal. Se o install o atributo é False, minimumRequiredVersion não deve ser conjunto.

mapFileExtensions

Opcional. O padrão é False. If True, todos os arquivos na implantar devem ter uma extensão .implantar. ClickOnce será ajuste esta extensão fora desses arquivos, assim que ele baixa do servidor Web. Se você publicar seu aplicativo usando Visual Studio, ele adiciona automaticamente essa extensão a todos os arquivos. Este parâmetro permite que todos sistema autônomo arquivos dentro de um ClickOnceimplantação para download de um servidor Web que bloqueia a transmissão de arquivos que terminam em "não seguras" extensões sistema autônomo .exe.

disallowUrlActivation

Opcional. O padrão é False. If True, impede que um aplicativo seja inicializado por clicar no URL ou digitando o URL no Internet Explorer instalado. Se o install atributo não estiver presente, esse atributo é ignorado.

trustUrlParameters

Opcional. O padrão é False. If True, permite que a URL para conter os parâmetros de cadeia de caracteres de consulta que são passados para o aplicativo, assim 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 Cadeia de Caracteres de consulta em um aplicativo ClickOnce.

Se o disallowUrlActivation o atributo é True, trustUrlParameters deve ou ser excluídos do manifesto ou explicitamente definida como False.

The deployment elemento também contém os seguintes elementos filho.

assinatura

Opcional. Contém o update elemento. The subscription elemento tem sem atributos. Se o subscription elemento não existe, o ClickOnce aplicativo nunca irá procurar por atualizações. Se o install atributo das deployment o elemento é False, the 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 do subscription elemento e contenha o beforeApplicationStartup ou o expiration elemento. beforeApplicationStartup e expiration não podem ser especificados no manifesto de implantação do mesmo.

The update elemento tem sem atributos.

beforeApplicationStartup

Opcional. Este elemento é filho do update elemento e sem atributos. Quando o beforeApplicationStartup elemento existe, o aplicativo será bloqueada quando ClickOnce verifica se há atualizações, se o cliente estiver online. Se este elemento não existir, ClickOnce primeiro irá procurar por atualizações com base nos valores especificados para o expiration elemento. beforeApplicationStartup e expiration não podem ser especificados no manifesto de implantação do mesmo.

expiração

Opcional. Este elemento é filho do update elemento, e não tem filhos. beforeApplicationStartup e expiration não podem ser especificados no manifesto de implantação do mesmo.

The expiration elemento suporta os seguintes atributos.

Atributo

Descrição

maximumAge

Obrigatório. Identifica velhos a atualização corrente deve se tornar antes do aplicativo executa uma verificação de atualização. A unidade de time é determinada pelo unit atributo.

unit

Obrigatório. Identifica a unidade de time para maximumAge. válido unidades são horas, dias, and semanas.

deploymentProvider

Para .NET estrutura 2.0, é necessário se o manifesto de implantação contém um subscription seção; caso contrário, opcional. Para .NET estrutura 3.5, 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 do deployment elemento e tem o atributo a seguir.

Atributo

Descrição

codeBase

Obrigatório. Identifica o local, sistema autônomo um URI Uniform recurso identificador (), do manifesto de implantação é usado para atualizar o ClickOnce aplicativo. Esse elemento também permite encaminhamento locais de atualização para instalações baseadas em CD. Deve ser um URI válido.

Comentários

Você pode configurar o seu ClickOnce aplicativo para verificar se há atualizações na inicialização, procurar por atualizações após a inicialização ou nunca verificar atualizações. Para procurar por atualizações na inicialização, verifique se o beforeApplicationStartup elemento existe sob a update elemento.

Para procurar por atualizações após a inicialização, verifique se o expiration elemento existe sob a update elemento e que os intervalos de atualização desejados são fornecidos.

Para desabilitar a verificação para atualizações, remova o subscription elemento. Quando você especifica no manifesto de implantação para nunca verificar atualizações, você pode ainda verificar manualmente as atualizações usando o CheckForUpdate método.

Para obter mais informações sobre como deploymentProvider está relacionado a atualizações, consulte Escolhendo uma estratégia de Atualizar do ClickOnce.

Exemplos

O exemplo de código a seguir ilustra um deployment elemento em um ClickOnce manifesto de implantação. O exemplo usa um deploymentProvider elemento para indicar o local preferido de atualização. O exemplo de código é parte de um exemplo maior fornecido para o Manifesto de implantação do ClickOnce tópico.

<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>

Consulte também

Referência

Manifesto Deployment ClickOnce