System.Deployment.Application Espace de noms

À l’aide de l’espace de noms System.Deployment.Application, vous pouvez programmer un comportement de mise à niveau personnalisé dans votre application ClickOnce. With the System.Deployment.Application namespace, you can program custom upgrade behavior into your ClickOnce application.

Classes

ApplicationDeployment

Prend en charge les mises à jour du déploiement actuel par programme, et gère le téléchargement de fichiers à la demande.Supports updates of the current deployment programmatically, and handles on-demand downloading of files. Cette classe ne peut pas être héritée.This class cannot be inherited.

CheckForUpdateCompletedEventArgs

Représente des informations de mise à jour détaillées obtenues par l'intermédiaire d'un appel à CheckForUpdateAsync().Represents detailed update information obtained through a call to CheckForUpdateAsync().

CompatibleFramework

Représente une version du .NET Framework sur laquelle une application peut être installée et exécutée.Represents a version of the .NET Framework where an application can install and run.

CompatibleFrameworkMissingException

Cette exception est levée lorsqu'aucune version du .NET Framework compatible avec cette application ne peut être trouvée.This exception is thrown when a version of the .NET Framework that is compatible with this application cannot be found.

CompatibleFrameworks

Fournit des détails à propos des versions du .NET Framework sur lesquelles cette application peut être installée et exécutée.Provides details about versions of the .NET Framework on which this application can install and run.

DependentPlatformMissingException

Exception levée lorsque la dépendance de plateforme n'a pas été trouvée pendant l'activation du déploiement ClickOnce et que le déploiement ne s'exécutera pas.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

Indique qu’il existe une erreur de téléchargement des manifestes ClickOnce ou des fichiers de déploiement sur l’ordinateur client.Indicates that there was an error downloading either the ClickOnce manifests or the deployment's files to the client computer.

DeploymentException

Définit une classe de base pour toutes les exceptions liées au déploiement.Defines a base class for all deployment-related exceptions.

DeploymentProgressChangedEventArgs

Représente les données de progression rapportées dans une opération asynchrone.Represents progress data reported in an asynchronous operation.

DeploymentServiceCom

Fournit des services internes pour l’API du déploiement ClickOnce.Provides internal services for the ClickOnce deployment API.

DownloadApplicationCompletedEventArgs

Fournit des données pour l'événement DownloadApplicationCompleted.Provides data for the DownloadApplicationCompleted event.

DownloadFileGroupCompletedEventArgs

Décrit un téléchargement de fichier récent.Describes a file download that has recently completed.

DownloadProgressChangedEventArgs

Fournit des données pour l'événement DownloadProgressChanged.Provides data for the DownloadProgressChanged event.

GetManifestCompletedEventArgs

Fournit des données pour l'événement GetManifestCompleted de InPlaceHostingManager.Provides data for the GetManifestCompleted event of InPlaceHostingManager.

InPlaceHostingManager

Installe ou met à jour un déploiement ClickOnce sur un ordinateur.Install or update a ClickOnce deployment on a computer.

InvalidDeploymentException

Indique que ClickOnce n’a pas pu lire les manifestes de déploiement ou de l’application.Indicates that ClickOnce could not read either the deployment or application manifests.

SupportedRuntimeMissingException

Cette exception est levée lorsqu'aucune version du runtime compatible avec cette application ne peut être trouvée.This exception is thrown when a runtime version that is compatible with this application cannot be found.

TrustNotGrantedException

Indique que l'application n'a pas le niveau de confiance approprié pour s'exécuter sur l'ordinateur local.Indicates that the application does not have the appropriate level of trust to run on the local computer.

UpdateCheckInfo

Représente des informations de mise à jour détaillées obtenues par l'intermédiaire d'un appel à CheckForDetailedUpdate().Represents detailed update information obtained through a call to CheckForDetailedUpdate().

Énumérations

DeploymentProgressState

Spécifie l’étape en cours d’une opération de téléchargement ClickOnce.Specifies the current stage of a ClickOnce download operation.

Délégués

CheckForUpdateCompletedEventHandler

Représente la méthode qui gérera l’événement CheckForUpdateCompleted d’un ApplicationDeployment.Represents the method that will handle the CheckForUpdateCompleted event of an ApplicationDeployment.

DeploymentProgressChangedEventHandler

Représente la méthode qui gérera l'événement CheckForUpdateProgressChanged, l'événement UpdateProgressChanged, ou l'événement DownloadFileGroupProgressChanged de ApplicationDeployment.Represents the method that will handle the CheckForUpdateProgressChanged event, UpdateProgressChanged event, or DownloadFileGroupProgressChanged event of an ApplicationDeployment.

DownloadFileGroupCompletedEventHandler

Représente la méthode qui gérera l’événement DownloadFileGroupCompleted d’un ApplicationDeployment.Represents the method that will handle the DownloadFileGroupCompleted event of an ApplicationDeployment.

Remarques

La classe de clé de cet espace de noms est ApplicationDeployment .The key class in this namespace is ApplicationDeployment. Vous pouvez tester si votre déploiement dispose d’une mise à jour disponible à l’aide des CheckForUpdate CheckForUpdateAsync méthodes ou ; la dernière méthode déclenche l' CheckForUpdateCompleted événement une fois qu’elle s’est terminée avec succès.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. CheckForDetailedUpdateretourne des informations importantes sur la mise à jour, telles que son numéro de version et s’il s’agit d’une mise à jour obligatoire pour les utilisateurs actuels.CheckForDetailedUpdate returns important information about the update, such as its version number and whether it is a required update for current users. Si une mise à jour est disponible, vous pouvez l’installer à l’aide de Update ou UpdateAsync ; la dernière méthode déclenche l' UpdateCompleted événement une fois l’installation de la mise à jour terminée.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. Pour les mises à jour volumineuses, vous pouvez recevoir des notifications de progression via les CheckForUpdateProgressChanged UpdateProgressChanged événements et, et utiliser les informations dans ProgressChangedEventArgs pour informer l’utilisateur de l’état du téléchargement.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.

Vous pouvez également utiliser ApplicationDeployment pour télécharger des fichiers volumineux et des assemblys à la demande.You can also use ApplicationDeployment to download large files and assemblies on demand. Ces fichiers doivent être marqués comme « facultatifs » dans le manifeste de l’application du déploiement, afin qu’ils ne soient pas téléchargés lors de l’installation.These files must be marked as "optional" within the deployment's application manifest, so that they are not downloaded at installation. Vous pouvez télécharger les fichiers à tout moment pendant la durée de l’application à l’aide des DownloadFileGroup DownloadFileGroupAsync méthodes ou.You can download the files at any point during the application's duration by using the DownloadFileGroup or DownloadFileGroupAsync methods. Vous pouvez télécharger des assemblys avant leur chargement dans la mémoire en fournissant un gestionnaire d’événements pour l' AssemblyResolve événement sur la AppDomain classe.You can download assemblies before they are loaded into memory by supplying an event handler for the AssemblyResolve event on the AppDomain class. Pour plus d’informations, consultez Procédure pas à pas : téléchargement d’assemblys à la demande avec l’API du déploiement ClickOnce à l’aide du concepteur.For more information, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API Using the Designer.