System.Deployment.Application Namespace

Con el espacio de nombres System.Deployment.Application, puede programar un comportamiento de actualización personalizado en la aplicación ClickOnce. With the System.Deployment.Application namespace, you can program custom upgrade behavior into your ClickOnce application.

Clases

ApplicationDeployment

Admite actualizaciones de la implementación actual mediante programación y controla la descarga de archivos a petición.Supports updates of the current deployment programmatically, and handles on-demand downloading of files. Esta clase no puede heredarse.This class cannot be inherited.

CheckForUpdateCompletedEventArgs

Representa información de actualización detallada que se ha obtenido llamando a CheckForUpdateAsync().Represents detailed update information obtained through a call to CheckForUpdateAsync().

CompatibleFramework

Representa una versión de .NET Framework donde se puede instalar y ejecutar una aplicación.Represents a version of the .NET Framework where an application can install and run.

CompatibleFrameworkMissingException

Esta excepción se inicia cuando no se puede encontrar una versión de .NET Framework que sea compatible con esta aplicación.This exception is thrown when a version of the .NET Framework that is compatible with this application cannot be found.

CompatibleFrameworks

Proporciona los detalles sobre las versiones de .NET Framework en las que se puede instalar y ejecutar esta aplicación.Provides details about versions of the .NET Framework on which this application can install and run.

DependentPlatformMissingException

Excepción que se inicia cuando no se encuentra la dependencia de la plataforma durante la activación de la implementación ClickOnce; la implementación no se ejecutará.The exception that is thrown when the platform dependency is not found during activation of the ClickOnce deployment and the deployment will not run.

DeploymentDownloadException

Indica que se ha producido un error al descargar al equipo cliente los manifiestos de ClickOnce o los archivos de la implementación.Indicates that there was an error downloading either the ClickOnce manifests or the deployment's files to the client computer.

DeploymentException

Define una clase base para todas las excepciones relacionadas con la implementación.Defines a base class for all deployment-related exceptions.

DeploymentProgressChangedEventArgs

Representa los datos de progreso de una operación asincrónica.Represents progress data reported in an asynchronous operation.

DeploymentServiceCom

Proporciona los servicios internos para la API de implementación de ClickOnce.Provides internal services for the ClickOnce deployment API.

DownloadApplicationCompletedEventArgs

Proporciona datos para el evento DownloadApplicationCompleted.Provides data for the DownloadApplicationCompleted event.

DownloadFileGroupCompletedEventArgs

Describe una descarga de archivos que ha finalizado recientemente.Describes a file download that has recently completed.

DownloadProgressChangedEventArgs

Proporciona datos para el evento DownloadProgressChanged.Provides data for the DownloadProgressChanged event.

GetManifestCompletedEventArgs

Proporciona datos para el evento GetManifestCompleted de un control InPlaceHostingManager.Provides data for the GetManifestCompleted event of InPlaceHostingManager.

InPlaceHostingManager

Instala o actualiza una implementación de ClickOnce en un equipo.Install or update a ClickOnce deployment on a computer.

InvalidDeploymentException

Indica que ClickOnce no pudo leer los manifiestos de implementación o aplicación.Indicates that ClickOnce could not read either the deployment or application manifests.

SupportedRuntimeMissingException

Se inicia esta excepción cuando no se puede encontrar una versión del runtime que sea compatible con esta aplicación.This exception is thrown when a runtime version that is compatible with this application cannot be found.

TrustNotGrantedException

Indica que la aplicación no tiene el nivel de confianza adecuado para ejecutarse en el equipo local.Indicates that the application does not have the appropriate level of trust to run on the local computer.

UpdateCheckInfo

Representa información de actualización detallada que se ha obtenido llamando a CheckForDetailedUpdate().Represents detailed update information obtained through a call to CheckForDetailedUpdate().

Enumeraciones

DeploymentProgressState

Especifica la fase actual de una operación de descarga de ClickOnce.Specifies the current stage of a ClickOnce download operation.

Delegados

CheckForUpdateCompletedEventHandler

Representa el método que controlará el evento CheckForUpdateCompleted de ApplicationDeployment.Represents the method that will handle the CheckForUpdateCompleted event of an ApplicationDeployment.

DeploymentProgressChangedEventHandler

Representa el método que controlará los eventos CheckForUpdateProgressChanged, UpdateProgressChanged o DownloadFileGroupProgressChanged de ApplicationDeployment.Represents the method that will handle the CheckForUpdateProgressChanged event, UpdateProgressChanged event, or DownloadFileGroupProgressChanged event of an ApplicationDeployment.

DownloadFileGroupCompletedEventHandler

Representa el método que controlará el evento DownloadFileGroupCompleted de ApplicationDeployment.Represents the method that will handle the DownloadFileGroupCompleted event of an ApplicationDeployment.

Comentarios

La clase clave en este espacio de nombres es ApplicationDeployment.The key class in this namespace is ApplicationDeployment. Se puede comprobar si la implementación tiene una actualización disponible mediante el uso del CheckForUpdate o CheckForUpdateAsync métodos; el segundo método que provoca el CheckForUpdateCompleted eventos cuando se ha completado correctamente.You can test whether your deployment has an available update by using either the CheckForUpdate or CheckForUpdateAsync methods; the latter method raises the CheckForUpdateCompleted event when it has successfully completed. CheckForDetailedUpdate Devuelve información importante sobre la actualización, como su número de versión y si es una actualización necesaria para los usuarios actuales.CheckForDetailedUpdate returns important information about the update, such as its version number and whether it is a required update for current users. Si hay disponible una actualización, puede instalarlo mediante Update o UpdateAsync; el último método provoca la UpdateCompleted eventos una vez finalizada la instalación de la actualización.If an update is available, you can install it by using Update or UpdateAsync; the latter method raises the UpdateCompleted event after installation of the update is finished. Para las actualizaciones grandes, puede recibir notificaciones de progreso a través de la CheckForUpdateProgressChanged y UpdateProgressChanged eventos y use la información de ProgressChangedEventArgs para notificar al usuario sobre el estado de descarga.For large updates, you can receive progress notifications through the CheckForUpdateProgressChanged and UpdateProgressChanged events, and use the information in ProgressChangedEventArgs to notify the user of the download status.

También puede usar ApplicationDeployment para descargar archivos de gran tamaño y los ensamblados a petición.You can also use ApplicationDeployment to download large files and assemblies on demand. Estos archivos se deben marcar como "opcionales" en el manifiesto de aplicación de la implementación, por lo que no se descargan durante la instalación.These files must be marked as "optional" within the deployment's application manifest, so that they are not downloaded at installation. Puede descargar los archivos en cualquier momento durante la duración de la aplicación mediante el uso de la DownloadFileGroup o DownloadFileGroupAsync métodos.You can download the files at any point during the application's duration by using the DownloadFileGroup or DownloadFileGroupAsync methods. Puede descargar los ensamblados antes de que se cargan en memoria proporcionando un controlador de eventos para el AssemblyResolve eventos en el AppDomain clase.You can download assemblies before they are loaded into memory by supplying an event handler for the AssemblyResolve event on the AppDomain class. Para más información, consulte Tutorial: Descargar ensamblados a petición con la API de implementación de ClickOnce mediante el diseñador.For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.