Idioma

<elemento de implantação> (implantação do ClickOnce)

Identifica os atributos usados para a implantaçã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 é necessário e está no urn:schemas-microsoft-com:asm.v2 namespace. O elemento tem os seguintes atributos.

Attribute Description
install Required. Especifica se esse aplicativo define uma presença no menu iniciar Windows e no aplicativo Painel de Controle Adicionar ou Remover Programas. 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á o subscription elemento.
minimumRequiredVersion Optional. Especifica a versão mínima deste aplicativo que pode ser executada 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 está um inteiro sem sinal. Se o install atributo for false, minimumRequiredVersion não deverá ser definido.
mapFileExtensions Optional. Usa false como padrão. Se truetodos os arquivos na implantação precisarem ter uma extensão .deploy. O ClickOnce removerá essa extensão desses arquivos assim que os baixar do servidor Web. Se você publicar seu aplicativo usando Visual Studio, ele adicionará automaticamente essa extensão a todos os arquivos. Esse parâmetro permite que todos os arquivos em uma implantação do ClickOnce sejam baixados de um servidor Web que bloqueia a transmissão de arquivos que terminam em extensões "não seguras", como .exe.
disallowUrlActivation Optional. Usa false como padrão. Se true, impede que um aplicativo instalado seja iniciado clicando na URL ou inserindo a URL em um navegador. Se o install atributo não estiver presente, esse atributo será ignorado.
trustURLParameters Optional. Usa false como padrão. Se true, permite que a URL contenha 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 Online.

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

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

assinatura

Optional. Contém o update elemento. O subscription elemento não tem atributos. Se o subscription elemento não existir, o aplicativo ClickOnce nunca verificará se há atualizações. Se o install atributo do deployment elemento for false, o subscription elemento será ignorado, pois um aplicativo ClickOnce que é iniciado da rede sempre usa a versão mais recente.

atualização

Required. Esse elemento é um filho do subscription elemento e contém o elemento ou o expirationbeforeApplicationStartup elemento. beforeApplicationStartup e expiration não pode ser especificado no mesmo manifesto de implantação.

O update elemento não tem atributos.

beforeApplicationStartup

Optional. Esse elemento é um filho do update elemento e não tem atributos. Quando o beforeApplicationStartup elemento existir, o aplicativo será bloqueado quando o ClickOnce verificar se há atualizações, se o cliente estiver online. Se esse elemento não existir, ClickOnce primeiro verificará se há atualizações com base nos valores especificados para o expiration elemento. beforeApplicationStartup e expiration não pode ser especificado no mesmo manifesto de implantação.

Expiração

Optional. Esse elemento é um filho do update elemento e não tem filhos. beforeApplicationStartup e expiration não pode ser especificado 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 é executada. Em seguida, a nova versão é instalada na próxima inicialização do aplicativo ClickOnce.

O expiration elemento dá suporte aos atributos a seguir.

Attribute Description
maximumAge Required. Identifica a idade da atualização atual antes que o aplicativo execute 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, dayse weeks.

deploymentProvider

Para o .NET Framework 2.0, esse elemento será necessário se o manifesto de implantação contiver uma subscription seção. Para o .NET Framework 3.5 e posterior, esse elemento é opcional e será o padrão para o servidor e o caminho do arquivo no qual o manifesto de implantação foi descoberto.

Esse elemento é um filho do deployment elemento e tem o atributo a seguir.

Attribute Description
codebase Required. Identifica o local, como um URI (Uniform Resource Identifier), do manifesto de implantação usado para atualizar o aplicativo ClickOnce. Esse elemento também permite encaminhar locais de atualização para instalações baseadas em CD. Deve ser um URI válido.

Observações

Você pode configurar seu aplicativo ClickOnce para verificar se há atualizações na inicialização, verificar se há atualizações após a inicialização ou nunca verificar se há atualizações. Para verificar se há atualizações na inicialização, verifique se o beforeApplicationStartup elemento existe no update elemento. Para verificar se há atualizações após a inicialização, verifique se o expiration elemento existe no update elemento e se 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, ainda pode verificar manualmente se há atualizações usando o CheckForUpdate método.

Note

A ApplicationDeployment classe e as APIs no System.Deployment.Application namespace não são compatíveis com .NET Core e .NET 5 e versões posteriores. No .NET 7, há suporte para um novo método de acesso às propriedades de implantação do aplicativo. Para obter mais informações, consulte as propriedades de implantação do Access ClickOnce no .NET. O .NET 7 não dá suporte ao equivalente aos métodos ApplicationDeployment.

Para obter mais informações sobre como deploymentProvider se relaciona com atualizações, consulte Escolhendo uma estratégia de atualização do ClickOnce.

Examples

O exemplo de código a seguir ilustra um deployment elemento em um manifesto de implantação do ClickOnce. O exemplo usa um deploymentProvider elemento para indicar o local de atualização preferencial.

<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

  • Última atualização em