Elemento <entryPoint> (aplicación ClickOnce)
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>