Remarque : cet espace de noms est nouveau dans le .NET Framework version 2.0.

À l'aide de l'espace de noms System.Deployment.Application, vous pouvez programmer un comportement de mise à jour personnalisé dans votre application ClickOnce.

La classe clé de cet espace de noms est ApplicationDeployment. Pour savoir si votre déploiement a une mise à jour disponible, vous pouvez utiliser les méthodes CheckForUpdate ou CheckForUpdateAsync ; cette dernière déclenche l'événement CheckForUpdateCompleted si l'opération réussit. CheckForDetailedUpdate retourne des informations importantes à propos de la mise à jour, telles que son numéro de version et le fait qu'elle est ou non requise pour les utilisateurs actuels. Si une mise à jour est disponible, vous pouvez l'installer en utilisant Update ou UpdateAsync ; la dernière méthode déclenche l'événement UpdateCompleted une fois que l'installation de la mise à jour est terminée. Pour les mises à jour plus volumineuses, vous pouvez recevoir des notifications relatives à l'avancement par l'intermédiaire des événements CheckForUpdateProgressChanged et UpdateProgressChanged, et utiliser les informations contenues dans ProgressChangedEventArgs pour indiquer à l'utilisateur l'état d'avancement du téléchargement.

Vous pouvez également utiliser ApplicationDeployment pour télécharger les fichiers volumineux et les assemblys à la demande. Ces fichiers doivent être marqués comme « facultatifs » dans le manifeste de déploiement de l'application, pour ne pas être téléchargés à l'installation. Vous pouvez télécharger les fichiers à tout moment pendant la durée d'exécution de l'application en utilisant les méthodes DownloadFileGroup ou DownloadFileGroupAsync. Vous pouvez télécharger des assemblys avant qu'ils ne soient chargés en mémoire en fournissant un gestionnaire d'événements pour l'événement AssemblyResolve sur la classe AppDomain. 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.

Classes

	Classe	Description
	ApplicationDeployment	Prend en charge les mises à jour du déploiement actuel par programme, ainsi que le téléchargement de fichiers à la demande. Cette classe ne peut pas être héritée.
	CheckForUpdateCompletedEventArgs	Représente des informations de mise à jour détaillées obtenues par l'intermédiaire d'un appel à CheckForUpdateAsync.
	DependentPlatformMissingException	Indique que la dépendance de plate-forme n'a pas été trouvée pendant l'activation du déploiement ClickOnce, et que le déploiement ne s'exécutera pas.
	DeploymentDownloadException	Indique qu'il y a eu une erreur de téléchargement des manifestes ClickOnce ou des fichiers de déploiement sur l'ordinateur client.
	DeploymentException	Définit une classe de base pour toutes les exceptions liées au déploiement.
	DeploymentProgressChangedEventArgs	Représente les données de progression rapportées dans une opération asynchrone.
	DeploymentServiceCom	Fournit des services internes pour l'API du déploiement ClickOnce.
	DownloadApplicationCompletedEventArgs	Fournit des données pour l'événement DownloadApplicationCompleted.
	DownloadFileGroupCompletedEventArgs	Décrit un téléchargement de fichier récent.
	DownloadProgressChangedEventArgs	Fournit des données pour l'événement DownloadProgressChanged.
	GetManifestCompletedEventArgs	Fournit des données pour l'événement GetManifestCompleted.
	InPlaceHostingManager	Gère un déploiement ClickOnce.
	InvalidDeploymentException	Indique que ClickOnce n'a pas pu lire les manifestes de déploiement ou de l'application.
	TrustNotGrantedException	Indique que l'application n'a pas le niveau de confiance approprié pour s'exécuter sur l'ordinateur local.
	UpdateCheckInfo	Représente des informations de mise à jour détaillées obtenues par l'intermédiaire d'un appel à CheckForDetailedUpdate.

Délégués

	Délégué	Description
	CheckForUpdateCompletedEventHandler	Représente la méthode qui gérera l'événement CheckForUpdateCompleted de 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.
	DownloadFileGroupCompletedEventHandler	Représente la méthode qui gérera l'événement DownloadFileGroupCompleted de ApplicationDeployment.

Énumérations

	Énumération	Description
	DeploymentProgressState	Spécifie l'étape en cours d'une opération de téléchargement ClickOnce.