Elemento <entryPoint> (aplicación ClickOnce)

  • Artículo

Identifica el ensamblado que se debe ejecutar cuando se ejecuta esta aplicación ClickOnce en un equipo cliente.

Sintaxis

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

Elementos y atributos

El elemento entryPoint es obligatorio y se encuentra en el espacio de nombres urn:schemas-microsoft-com:asm.v2 . Sólo se puede definir un elemento entryPoint en un manifiesto de aplicación.

El elemento entryPoint tiene el siguiente atributo.

Atributo Descripción
name Opcional. .NET Framework no usa este valor.

entryPoint tiene los siguientes elementos.

assemblyIdentity

Necesario. El rol de assemblyIdentity y sus atributos se define en el<elemento> assemblyIdentity.

El atributo processorArchitecture de este elemento y el atributo processorArchitecture definido en assemblyIdentity en el manifiesto de aplicación deben coincidir.

commandLine

Necesario. El elemento entryPoint debe ser un elemento secundario del elemento. No contiene elementos secundarios y tiene los siguientes atributos.

Atributo Descripción
file Necesario. Una referencia local al ensamblado de inicio de la aplicación ClickOnce. Este valor no puede contener separadores de ruta de acceso de barra diagonal (/) o barra diagonal inversa (\).
parameters Necesario. Describe la acción que se va a realizar con el punto de entrada. El único valor válido es run; si se proporciona una cadena en blanco, run se supone.

customHostRequired

Opcional. Si se incluye, especifica que esta implementación contiene un componente que se implementará dentro de un host personalizado y no es una aplicación independiente.

Si este elemento está presente, los elementos assemblyIdentity y commandLine no deben estar presentes. Si lo están, ClickOnce generará un error de validación durante la instalación.

Este elemento no tiene atributos ni elementos secundarios.

customUX

Opcional. Especifica que la aplicación está instalada y mantenida por un instalador personalizado y no crea una entrada de menú Inicio, acceso directo o Agregar o quitar programas.

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

Una aplicación que incluya el elemento customUX debe proporcionar un instalador personalizado que use la clase InPlaceHostingManager para realizar operaciones de instalación. No se puede instalar una aplicación con este elemento haciendo doble clic en su manifiesto o setup.exe programa previo setup.exe. El instalador personalizado puede crear entradas de menú Inicio, accesos directos y agregar o quitar entradas de programas. Si el instalador personalizado no crea una entrada Agregar o quitar programas, debe almacenar el identificador de suscripción proporcionado por la propiedad SubscriptionIdentity y permitir que el usuario desinstale la aplicación más adelante llamando al método UninstallCustomUXApplication. Para obtener más información, consulte Tutorial: Crear un instalador personalizado para una aplicación ClickOnce.

Comentarios

Este elemento identifica el ensamblado y el punto de entrada de la aplicación ClickOnce.

No se puede usar commandLine para pasar parámetros a la aplicación en tiempo de ejecución. Puede obtener acceso a los parámetros de cadena de consulta para una implementación ClickOnce desde AppDomain de la aplicación. Para obtener más información, consulte Cómo: Recuperar información de la cadena de consulta de una aplicación de ClickOnce en línea.

Ejemplo

En el siguiente ejemplo de código se muestra el elemento entryPoint de un manifiesto de aplicación para una aplicación de ClickOnce. Este ejemplo de código forma parte de un ejemplo más extenso incluido en el tema Manifiesto de aplicación 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>

Consulte también