Lenguaje

<elemento deployment> (implementación ClickOnce)

Identifica los atributos usados para la implementación de actualizaciones y exposición al sistema.

Sintaxis


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

Elementos y atributos

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

Attribute Description
install Required. Especifica si esta aplicación define una presencia en el menú Inicio de Windows y en la aplicación Agregar o quitar programas de Panel de control. Los valores válidos son true y false. Si falsees , ClickOnce siempre ejecutará la versión más reciente de esta aplicación desde la red y no reconocerá el subscription elemento .
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 menor que el 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 install atributo es false, minimumRequiredVersion no debe establecerse.
mapFileExtensions Opcional. Tiene como valor predeterminado false. Si truees , 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, agrega automáticamente esta extensión a todos los archivos. Este parámetro permite descargar todos los archivos 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 truees , 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 install atributo no está presente, se omite este atributo.
trustURLParameters Opcional. Tiene como valor predeterminado false. Si truees , permite que la dirección URL contenga parámetros de cadena de consulta que se pasan a la aplicación, al igual que 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, vea Cómo: Recuperar información de cadena de consulta en una aplicación ClickOnce en línea.

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

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

subscription

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

update

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

El update elemento no tiene atributos.

beforeApplicationStartup

Opcional. Este elemento es un elemento secundario del update elemento y no tiene atributos. beforeApplicationStartup Cuando el elemento existe, 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 expiration elemento. beforeApplicationStartup y expiration no se pueden especificar en el mismo manifiesto de implementación.

expiración

Opcional. Este elemento es un elemento secundario del update elemento 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 actualización 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 ClickOnce.

El expiration elemento admite los siguientes atributos.

Attribute Description
maximumAge Required. Identifica la antigüedad de la actualización actual antes de que la aplicación realice una comprobación de actualización. El atributo determina la unit unidad de tiempo.
unit Required. Identifica la unidad de tiempo de maximumAge. Las unidades válidas son hours, daysy weeks.

deploymentProvider

Para el .NET Framework 2.0, este elemento es necesario si el manifiesto de implementación contiene una subscription sección. Para la .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 deployment elemento y tiene el atributo siguiente.

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

Observaciones

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

Para deshabilitar la comprobación de actualizaciones, quite el subscription elemento . Al especificar en el manifiesto de implementación para que nunca busque actualizaciones, todavía puede comprobar manualmente las actualizaciones mediante el CheckForUpdate método .

Note

La ApplicationDeployment clase y las API del System.Deployment.Application espacio de nombres no se admiten en .NET Core y .NET 5 ni en 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 Access ClickOnce deployment properties in .NET (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 ClickOnce.

Ejemplos

En el ejemplo de código siguiente se muestra un deployment elemento en un manifiesto de implementación clickOnce. En el ejemplo se usa un deploymentProvider elemento 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>

Véase también

  • Se actualizó por última vez el