Elemento <entryPoint> (Aplicación ClickOnce)
Identifica el ensamblado que se debe ejecutar cuando esta aplicación ClickOnce se ejecuta en un equipo cliente.
<entryPoint
name
>
<assemblyIdentity
name
version
processorArchitecture
language
/>
<commandLine
file
parameters
/>
<customHostRequired />
<customUX />
</entryPoint>
Elementos y atributos
Se requiere el elemento entryPoint, que se encuentra en el espacio de nombres urn:schemas-microsoft-com:asm.v2. Puede haber sólo uno elemento entryPoint definido en un manifiesto de aplicación.
El elemento entryPoint tiene el siguiente atributo.
Atributo |
Descripción |
|---|---|
name |
Opcional. .NET Framework no utiliza este valor. |
entryPoint tiene los elementos siguientes.
assemblyIdentity
Obligatorio. El rol de assemblyIdentity y sus atributos se define en Elemento <assemblyIdentity> (Aplicación ClickOnce).
El atributo processorArchitecture de este elemento y el atributo processorArchitecture, definidos en assemblyIdentity en alguna parte del manifiesto de aplicación, deben coincidir.
commandLine
Obligatorio. Debe ser un elemento secundario del elemento entryPoint. No tiene ningún elemento secundario y tiene los atributos siguientes.
Atributo |
Descripción |
|---|---|
file |
Obligatorio. Referencia local al ensamblado de inicio para la aplicación ClickOnce. Este valor no puede contener separadores de ruta de acceso de barra diagonal (/) o de barra diagonal inversa (\). |
parameters |
Obligatorio. Describe la acción que se llevará a cabo con el punto de entrada. El único valor válido es run; si se proporciona una cadena vacía, se supone el valor run. |
customHostRequired
Opcional. Si está incluido, 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 commandLine y assemblyIdentity no deben estar presentes. Si están, ClickOnce producirá un error de validación durante la instalación.
Este elemento no tiene ningún atributo y ningún elemento secundario.
customUX
Opcional. Especifica que un instalador personalizado instala y mantiene la aplicación, y que no se crea ninguna entrada del menú Inicio, acceso directo o entrada de Agregar o quitar programas.
<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />
Una aplicación que incluye el elemento customUX debe proporcionar un instalador personalizado que utiliza la clase InPlaceHostingManager para realizar las operaciones de la instalación. Una aplicación con este elemento no se puede instalar haciendo doble clic en su arranque de requisito previo de setup.exe o de manifiesto. El instalador personalizado puede crear entradas del menú Inicio, accesos directos y entradas de Agregar o quitar programas. Si el instalador personalizado no crea una entrada Agregar o quitar programas, deberá almacenar el identificador de suscripción proporcionado por la propiedad SubscriptionIdentity y habilitar al usuario para desinstalar posteriormente la aplicación mediante una llamada al método UninstallCustomUXApplication. Para obtener más información, vea 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 utilizar commandLine para pasar parámetros en su aplicación en tiempo de ejecución. Puede tener acceso a los parámetros de cadena de consulta de una implementación de ClickOnce desde el AppDomain de la aplicación. Para obtener más información, vea Cómo: Recuperar información de la cadena de consulta de una aplicación ClickOnce en línea.
Ejemplo
En el siguiente ejemplo de código se muestran un elemento entryPoint de un manifiesto de aplicación para una aplicación ClickOnce. Este ejemplo de código forma parte de un ejemplo más extenso que aparece 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>