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>