Idioma

<Elemento de implementação> (implementação ClickOnce)

Identifica os atributos usados para a implementação de atualizações e exposição ao sistema.

Sintaxe


      <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á no urn:schemas-microsoft-com:asm.v2 namespace. O elemento tem as seguintes características.

Attribute Description
install Required. Especifica se esta aplicação define uma presença no menu Iniciar do Windows e no Painel de Controlo Adicionar ou Remover Programas. Os valores válidos são true e false. Se false, o ClickOnce executará sempre a versão mais recente desta aplicação a partir da rede e não reconhecerá o subscription elemento.
minimumRequiredVersion Optional. Especifica a versão mínima desta aplicação que pode correr no cliente. Se o número de versão da aplicação for inferior ao número de versão fornecido no manifesto de implementação, a aplicação não será executada. Os números de versão devem ser especificados no formato N.N.N.N, onde N é um inteiro sem sinal. Se o install atributo for false, minimumRequiredVersion não pode ser definido.
mapFileExtensions Optional. O valor padrão é false. Se true, todos os ficheiros na implementação devem ter uma extensão .deploy. O ClickOnce remove esta extensão destes ficheiros assim que os descarregar do servidor Web. Se publicar a sua aplicação usando o Visual Studio, esta extensão adiciona automaticamente a todos os ficheiros. Este parâmetro permite que todos os ficheiros dentro de uma implementação ClickOnce sejam descarregados de um servidor Web que bloqueia a transmissão de ficheiros que terminam em extensões "inseguras" como .exe.
disallowUrlActivation Optional. O valor padrão é false. Se true, impede que uma aplicação instalada seja iniciada clicando no URL ou introduzindo o URL num navegador. Se o install atributo não estiver presente, este atributo é ignorado.
trustURLParameters Optional. O valor padrão é false. Se true, permite que a URL contenha parâmetros de cadeia de consulta que são passados para a aplicação, tal como argumentos de linha de comandos são passados para uma aplicação de linha de comandos. Para mais informações, veja Como: Recuperar Informação de Sequência de Consulta numa Aplicação Online ClickOnce.

Se o atributo disallowUrlActivation for true, trustUrlParameters deve ser excluído do manifesto, ou explicitamente definido como false.

O deployment elemento contém também os seguintes elementos filhos.

subscrição

Optional. Contém o update elemento. O subscription elemento não tem atributos. Se o subscription elemento não existir, a aplicação ClickOnce nunca irá analisar atualizações. Se o install atributo do deployment elemento for false, o subscription elemento é ignorado, porque uma aplicação ClickOnce lançada a partir da rede usa sempre a versão mais recente.

actualização

Required. Este elemento é filho do subscription elemento e contém ou o beforeApplicationStartup ou o expiration elemento. beforeApplicationStartup e expiration não podem ambos ser especificados no mesmo manifesto de implementação.

O update elemento não tem atributos.

beforeApplicationStartup

Optional. Este elemento é filho do update elemento e não tem atributos. Quando o beforeApplicationStartup elemento existe, a aplicação será bloqueada quando o ClickOnce verificar atualizações, caso o cliente esteja online. Se este elemento não existir, o ClickOnce irá primeiro procurar atualizações com base nos valores especificados para o expiration elemento. beforeApplicationStartup e expiration não podem ambos ser especificados no mesmo manifesto de implementação.

expiração

Optional. Este elemento é filho do update elemento e não tem filhos. beforeApplicationStartup e expiration não podem ambos ser especificados no mesmo manifesto de implementação. Quando ocorre a verificação de atualização e é detetada uma versão atualizada, a nova versão armazena em cache enquanto a versão existente está a correr. A nova versão instala-se depois no próximo lançamento da aplicação ClickOnce.

O expiration elemento suporta os seguintes atributos.

Attribute Description
maximumAge Required. Identifica a idade da atualização atual antes de a aplicação realizar uma verificação de atualização. A unidade de tempo é determinada pelo unit atributo.
unit Required. Identifica a unidade de tempo para maximumAge. As unidades válidas são hours, days, e weeks.

Fornecedor de Implantação

Para o .NET Framework 2.0, este elemento é necessário se o manifesto de implementação contiver uma subscription secção. Para o .NET Framework 3.5 e posteriores, este elemento é opcional e irá automaticamente para o caminho do servidor e do ficheiro onde o manifesto de implementação foi descoberto.

Este elemento é filho do deployment elemento e tem o seguinte atributo.

Attribute Description
codebase Required. Identifica a localização, como Identificador Uniforme de Recursos (URI), do manifesto de implementação utilizado para atualizar a aplicação ClickOnce. Este elemento também permite encaminhar locais de atualização para instalações baseadas em CD. Deve ser um URI válido.

Remarks

Pode configurar a sua aplicação ClickOnce para escanear atualizações no arranque, verificar atualizações após o arranque, ou nunca verificar atualizações. Para verificar atualizações no arranque, certifique-se de que o beforeApplicationStartup elemento existe sob o update elemento. Para verificar atualizações após o arranque, certifique-se de que o expiration elemento existe sob o update elemento e que são fornecidos intervalos de atualização.

Para desativar a verificação de atualizações, remova o subscription elemento. Quando especificas no manifesto de implementação para nunca escanear atualizações, podes verificar manualmente as atualizações usando o CheckForUpdate método.

Note

A classe ApplicationDeployment e as APIs no namespace System.Deployment.Application não são suportadas no .NET Core e no .NET 5 e versões posteriores. No .NET 7, um novo método de acessar propriedades de implantação de aplicativo é suportado. Para obter mais informações, consulte Acessar propriedades de implantação do ClickOnce no .NET. O .NET 7 não suporta o equivalente aos métodos ApplicationDeployment.

Para mais informações sobre como o deploymentProvider se relaciona com atualizações, consulte Escolher uma Estratégia de Atualização Clickonce.

Examples

O exemplo de código seguinte ilustra um deployment elemento num manifesto de implementação ClickOnce. O exemplo utiliza um deploymentProvider elemento para indicar a localização preferida da 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>

Ver também

  • Última atualização a