Elemento <entryPoint> (aplicativo ClickOnce)

Identifica o assembly que deve ser executado quando este aplicativo ClickOnce é executado em um computador cliente.

Sintaxe

<entryPoint
   name
>
   <assemblyIdentity
      name
      version
      processorArchitecture
      language
   />
   <commandLine
      file
      parameters
   />
   <customHostRequired />
   <customUX />
</entryPoint>

Elementos e atributos

O elemento entryPoint é necessário e está no namespace urn:schemas-microsoft-com:asm.v2. Pode haver apenas um elemento entryPoint definido em um manifesto do aplicativo.

O elemento entryPoint tem o atributo a seguir.

Atributo	Descrição
name	Opcional. Esse valor não é usado pelo .NET Framework.

entryPoint tem os elementos a seguir.

assemblyIdentity

Obrigatórios. A função de assemblyIdentity e os respectivos é definida no elemento <assemblyIdentity>.

O atributo processorArchitecture desse elemento e o atributo processorArchitecture definido em assemblyIdentity em outro lugar no manifesto do aplicativo precisam corresponder.

commandLine

Obrigatórios. O elemento precisa ser filho do elemento entryPoint. Ele não tem elementos filho e tem os atributos a seguir.

Atributo	Descrição
file	Obrigatórios. Uma referência local ao assembly de inicialização do aplicativo ClickOnce. Esse valor não pode conter separadores de caminho de barra (/) ou barra invertida (\).
parameters	Obrigatórios. Descreve a ação a ser tomada com o ponto de entrada. O único valor válido é run; se uma cadeia de caracteres em branco for fornecida, run será assumido.

customHostRequired

Opcional. Se incluído, especifica que essa implantação contém um componente que será implantado dentro de um host personalizado e não é um aplicativo autônomo.

Se esse elemento estiver presente, os elementos assemblyIdentity e commandLine não poderão estar presentes também. Se estiverem, o ClickOnce gerará um erro de validação durante a instalação.

Esse elemento não tem atributos nem filhos.

customUX

Opcional. Especifica que o aplicativo é instalado e mantido por um instalador personalizado e não cria uma entrada no menu Iniciar, atalho ou entrada em Adicionar ou Remover Programas.

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

Um aplicativo que inclui o elemento customUX precisa fornecer um instalador personalizado que usa a classe InPlaceHostingManager para executar operações de instalação. Um aplicativo com esse elemento não pode ser instalado clicando duas vezes em seu manifesto ou no bootstrapper de pré-requisito setup.exe. O instalador personalizado pode criar entradas no menu Iniciar, atalhos e entradas em Adicionar ou Remover Programas. Se o instalador personalizado não criar uma entrada em Adicionar ou Remover Programas, ele precisará armazenar o identificador de assinatura fornecido pela propriedade SubscriptionIdentity e permitir que o usuário desinstale o aplicativo posteriormente chamando o método UninstallCustomUXApplication. Para obter mais informações, confira Passo a passo: criar um instalador personalizado para um aplicativo ClickOnce.

Comentários

Esse elemento identifica o assembly e o ponto de entrada do aplicativo ClickOnce.

Você não pode usar commandLine para passar parâmetros para seu aplicativo em tempo de execução. Você pode acessar parâmetros de cadeia de caracteres de consulta para uma implantação do ClickOnce do AppDomain do aplicativo. Para obter mais informações, confira Como recuperar informações de cadeia de caracteres de consulta em um aplicativo ClickOnce online.

Exemplo

O exemplo de código a seguir ilustra um elemento entryPoint em um manifesto do aplicativo para um aplicativo ClickOnce. Este exemplo de código faz parte de um exemplo maior fornecido para o tópico Manifesto de aplicativo ClickOnce.

<!-- Identify the main code entrypoint. -->
<!-- This code runs the main method in an executable assembly. -->
  <entryPoint>
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>

Confira também

• Manifesto do aplicativo ClickOnce