Share via

Elemento de <Implementación> (implementación de ClickOnce)

  • Artículo

Identifica los atributos utilizados para la implementación de actualizaciones y la exposición del sistema.

Sintaxis


      <deployment
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
>
   <subscription>
         <update>
            <beforeApplicationStartup/>
            <expiration
               maximumAge
               unit
            />
         </update>
   </subscription>
   <deploymentProvider
      codebase
   />
</deployment>

Elementos y atributos

El elemento deployment es obligatorio y se encuentra en el espacio de nombres urn:schemas-microsoft-com:asm.v2 . El elemento tiene los atributos siguientes.

Atributo Descripción
install Necesario. Especifica si esta aplicación define una presencia en el menú Inicio de Windows y en la aplicación Agregar o quitar programas del Panel de control. Los valores válidos son true y false. Si false, ClickOnce siempre ejecutará la versión más reciente de esta aplicación desde la red y no reconocerá el elemento subscription.
minimumRequiredVersion Opcional. Especifica la versión mínima de esta aplicación que se puede ejecutar en el cliente. Si el número de versión de la aplicación es inferior al número de versión proporcionado en el manifiesto de implementación, la aplicación no se ejecutará. Los números de versión deben especificarse en el formato N.N.N.N, donde N es un entero sin signo. Si el atributo install es false, minimumRequiredVersion no debe establecerse.
mapFileExtensions Opcional. Tiene como valor predeterminado false. Si true, todos los archivos de la implementación deben tener una extensión .deploy. ClickOnce quitará esta extensión de estos archivos tan pronto como los descargue del servidor web. Si publica la aplicación mediante Visual Studio, el programa agrega automáticamente esta extensión a todos los archivos. Este parámetro permite descargar todos los archivos dentro de una implementación de ClickOnce desde un servidor web que bloquea la transmisión de archivos que terminan en extensiones "no seguras", como .exe.
disallowUrlActivation Opcional. Tiene como valor predeterminado false. Si true, impide que se inicie una aplicación instalada haciendo clic en la dirección URL o escribiendo la dirección URL en un explorador. Si el atributo install no está presente, se omite este atributo.
trustURLParameters Opcional. Tiene como valor predeterminado false. Si true, permite que la dirección URL contenga parámetros de cadena de consulta que se pasan a la aplicación, de forma parecida a como los argumentos de la línea de comandos se pasan a una aplicación de línea de comandos. 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.

Si el atributo disallowUrlActivation es true, trustUrlParameters debe excluirse del manifiesto o establecerse explícitamente en false.

El elemento deployment también contiene los siguientes elementos secundarios.

subscription

Opcional. Contiene el elemento update. El elemento subscription no tiene atributos. Si el elemento subscription no existe, la aplicación de ClickOnce nunca buscará actualizaciones. Si el atributo install del elemento deployment es false, se omite el elemento subscription, porque una aplicación de ClickOnce que se inicia desde la red siempre usa la versión más reciente.

update

Necesario. Este elemento es un elemento secundario del elemento subscription y contiene el elemento beforeApplicationStartup o expiration. beforeApplicationStartup y expiration no se pueden especificar en el mismo manifiesto de implementación.

El elemento update no tiene atributos.

beforeApplicationStartup

Opcional. Este elemento es un elemento secundario del elemento update y no tiene atributos. Cuando el elemento beforeApplicationStartup exista, la aplicación se bloqueará cuando ClickOnce compruebe si hay actualizaciones, si el cliente está en línea. Si este elemento no existe, ClickOnce buscará primero actualizaciones en función de los valores especificados para el elemento expiration. beforeApplicationStartup y expiration no se pueden especificar en el mismo manifiesto de implementación.

expiration

Opcional. Este elemento es un elemento secundario del elemento update y no tiene elementos secundarios. beforeApplicationStartup y expiration no se pueden especificar en el mismo manifiesto de implementación. Cuando se produce la comprobación de actualizaciones y se detecta una versión actualizada, la nueva versión se almacena en caché mientras se ejecuta la versión existente. A continuación, la nueva versión se instala en el siguiente inicio de la aplicación de ClickOnce.

El elemento expiration admite los siguientes atributos.

Atributo Descripción
maximumAge Necesario. Identifica la antigüedad que debe alcanzar la actualización actual antes de que la aplicación realice una comprobación de actualizaciones. El atributo unit determina la unidad de tiempo.
unit Necesario. Identifica la unidad de tiempo de maximumAge. Las unidades válidas son hours, days y weeks.

deploymentProvider

Para .NET Framework 2.0, este elemento es necesario si el manifiesto de implementación contiene una sección subscription. Para .NET Framework 3.5 y versiones posteriores, este elemento es opcional y tendrá como valor predeterminado la ruta de acceso del servidor y del archivo en la que se detectó el manifiesto de implementación.

Este elemento es un elemento secundario del elemento deployment y tiene el siguiente atributo.

Atributo Descripción
codebase Necesario. Identifica la ubicación, como identificador uniforme de recursos (URI), del manifiesto de implementación que se usa para actualizar la aplicación de ClickOnce. Este elemento también permite reenviar ubicaciones de actualización para instalaciones basadas en CD. Debe ser un URI válido.

Comentarios

Puede configurar la aplicación de ClickOnce para buscar actualizaciones en el inicio, buscar actualizaciones después del inicio o nunca buscar actualizaciones. Para buscar actualizaciones en el inicio, asegúrese de que el elemento beforeApplicationStartup exista en el elemento update. Para buscar actualizaciones después del inicio, asegúrese de que el elemento expiration exista en el elemento update y de que se proporcionen intervalos de actualización.

Para deshabilitar la comprobación de actualizaciones, quite el elemento subscription. Al especificar en el manifiesto de implementación que nunca se busquen actualizaciones, sigue pudiendo comprobar manualmente las actualizaciones mediante el método CheckForUpdate.

Nota

La clase ApplicationDeployment y las API del espacio de nombres System.Deployment.Application no se admiten en .NET Core y .NET 5 y versiones posteriores. En .NET 7, se admite un nuevo método de acceso a las propiedades de implementación de aplicaciones. Para obtener más información, consulte Acceso a las propiedades de implementación de ClickOnce en .NET. .NET 7 no admite el equivalente de los métodos ApplicationDeployment.

Para obtener más información sobre cómo deploymentProvider se relaciona con las actualizaciones, consulte Elección de una estrategia de actualización de ClickOnce.

Ejemplos

En el ejemplo de código siguiente se muestra un elemento deployment en un manifiesto de implementación de ClickOnce. En el ejemplo se usa un elemento deploymentProvider para indicar la ubicación de actualización preferida.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

Consulte también