<implantação> Elemento (implantação deClickOnce )

Artigo
08/04/2011

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 é necessário e está no elemento a urn:schemas-microsoft-com:asm.v1 namespace. 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 executará a versão mais recente deste aplicativo da rede e não reconhecerá a subscription elemento.
minimumRequiredVersion	Opcional. Especifica a versão mínima do aplicativo que pode ser executado no cliente. Se o número de 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. Os números de versão devem ser especificados no formato n.n.n. n, onde n é um inteiro não assinado. Se o install atributo é false, minimumRequiredVersion não deve ser definido.
mapFileExtensions	Opcional. Padrões para false. Se true, todos os arquivos de implantação devem ter uma extensão. Deploy. ClickOnceirá remover esta extensão esses arquivos, assim que ele baixa do servidor Web. Se você publicar seu aplicativo usando Visual Studio, ele adiciona automaticamente essa extensão para todos os arquivos. Este parâmetro permite que todos os arquivos dentro de um ClickOnce implantação a ser baixado de um servidor Web que transmissão de blocos de arquivos que terminam em "não seguro" extensões como. exe.
disallowUrlActivation	Opcional. Padrões para false. Se true, impede que um aplicativo instalado que está sendo iniciado por clicar no URL ou digitando a URL no Internet Explorer. Se a install atributo não estiver presente, esse atributo é ignorado.
trustURLParameters	Opcional. Padrões para 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 How to: Recuperar informações de seqüência de caracteres de consulta em um aplicativo on-line ClickOnce. Se o 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 tem sem atributos. Se a subscription elemento não existir, o ClickOnce aplicativo nunca fará uma busca de atualizações. Se a install atributo da deployment elemento é false, o subscription elemento é ignorado, pois um ClickOnce aplicativo, que é 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 expiration elemento. beforeApplicationStartupe expiration não pode ser especificados no mesmo manifesto de implantação.

O update elemento tem sem atributos.

beforeApplicationStartup

Opcional. Este elemento é filho de update elemento e sem atributos. Quando o beforeApplicationStartup elemento existe, o aplicativo será bloqueado quando ClickOnce verifica atualizações, se o cliente estiver on-line. Se este elemento não existir, ClickOnce primeiro verificará atualizações de acordo com os valores especificados para o expiration elemento. beforeApplicationStartupe expiration não pode ser especificados no mesmo manifesto de implantação.

expiração

Opcional. Este elemento é filho de update elemento, e tem sem filhos. beforeApplicationStartupe expiration não pode ser especificados no mesmo manifesto de implantação. 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 aplicativo para verificar se há atualizações na inicialização, procurar por atualizações após a inicialização, ou nunca verificar se há atualizações. Para verificar se há atualizações na inicialização, certifique-se de que o beforeApplicationStartup elemento existe sob o update elemento. Para procurar por atualizações após a inicialização, certifique-se de 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 atualizações, você pode ainda verificar manualmente as atualizações 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 manifesto de implantação. O exemplo usa um deploymentProvider elemento para indicar o local preferida 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>

Consulte também

Referência

ClickOnce Manifesto de implantação

Compartilhar via