Langue

<élément deployment (déploiement> ClickOnce)

Identifie les attributs utilisés pour le déploiement des mises à jour et l’exposition au système.

Syntax


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

Éléments et attributs

L’élément deployment est obligatoire et se trouve dans l’espace urn:schemas-microsoft-com:asm.v2 de noms. L’élément a les attributs suivants.

Caractéristique Description
install Required. Spécifie si cette application définit une présence dans le menu Démarrer Windows et dans l’application Panneau de configuration Ajouter ou supprimer des programmes. Les valeurs valides sont true et false. Si false, ClickOnce exécute toujours la dernière version de cette application à partir du réseau et ne reconnaît pas l’élément subscription .
minimumRequiredVersion Optional. Spécifie la version minimale de cette application qui peut s’exécuter sur le client. Si le numéro de version de l’application est inférieur au numéro de version fourni dans le manifeste de déploiement, l’application ne s’exécute pas. Les numéros de version doivent être spécifiés au format N.N.N.N, où N est un entier non signé. Si l’attribut install est false, minimumRequiredVersion ne doit pas être défini.
mapFileExtensions Optional. La valeur par défaut est false. Si true, tous les fichiers du déploiement doivent avoir une extension .deploy. ClickOnce supprime cette extension dès qu’elle les télécharge à partir du serveur Web. Si vous publiez votre application à l’aide de Visual Studio, elle ajoute automatiquement cette extension à tous les fichiers. Ce paramètre permet à tous les fichiers d’un déploiement ClickOnce d’être téléchargés à partir d’un serveur Web qui bloque la transmission de fichiers se terminant par des extensions « non sécurisées », telles que .exe.
disallowUrlActivation Optional. La valeur par défaut est false. Si true, empêche un démarrage d’une application installée en cliquant sur l’URL ou en entrant l’URL dans un navigateur. Si l’attribut install n’est pas présent, cet attribut est ignoré.
trustURLParameters Optional. La valeur par défaut est false. Si true, permet à l’URL de contenir des paramètres de chaîne de requête passés dans l’application, comme les arguments de ligne de commande sont passés à une application de ligne de commande. Pour plus d’informations, consultez How to : Retrieve Query String Information in an Online ClickOnce Application.

Si l’attribut disallowUrlActivation est true, trustUrlParameters doit être exclu du manifeste ou défini explicitement sur false.

L’élément deployment contient également les éléments enfants suivants.

subscription

Optional. Contient l’élément update . L’élément subscription n’a aucun attribut. Si l’élément subscription n’existe pas, l’application ClickOnce n’analyse jamais les mises à jour. Si l’attribut install de l’élément deployment est false, l’élément subscription est ignoré, car une application ClickOnce lancée à partir du réseau utilise toujours la dernière version.

update

Required. Cet élément est un enfant de l’élément subscription et contient l’élément beforeApplicationStartup ou l’élément expiration . beforeApplicationStartup et expiration ne peut pas être spécifié dans le même manifeste de déploiement.

L’élément update n’a aucun attribut.

beforeApplicationStartup

Optional. Cet élément est un enfant de l’élément update et n’a aucun attribut. Quand l’élément beforeApplicationStartup existe, l’application est bloquée lorsque ClickOnce recherche les mises à jour, si le client est en ligne. Si cet élément n’existe pas, ClickOnce recherche d’abord les mises à jour en fonction des valeurs spécifiées pour l’élément expiration . beforeApplicationStartup et expiration ne peut pas être spécifié dans le même manifeste de déploiement.

date d'expiration

Optional. Cet élément est un enfant de l’élément update et n’a pas d’enfants. beforeApplicationStartup et expiration ne peut pas être spécifié dans le même manifeste de déploiement. Lorsque la vérification de la mise à jour se produit et qu’une version mise à jour est détectée, la nouvelle version est mise en cache pendant l’exécution de la version existante. La nouvelle version s’installe ensuite lors du lancement suivant de l’application ClickOnce.

L’élément expiration prend en charge les attributs suivants.

Caractéristique Description
maximumAge Required. Identifie l’ancienneté de la mise à jour actuelle avant que l’application n’effectue une vérification de mise à jour. L’unité de temps est déterminée par l’attribut unit .
unit Required. Identifie l’unité de temps pour maximumAge. Les unités valides sont hours, dayset weeks.

deploymentProvider

Pour le .NET Framework 2.0, cet élément est requis si le manifeste de déploiement contient une subscription section. Pour le .NET Framework 3.5 et versions ultérieures, cet élément est facultatif et est défini par défaut sur le serveur et le chemin d’accès de fichier dans lequel le manifeste de déploiement a été découvert.

Cet élément est un enfant de l’élément deployment et a l’attribut suivant.

Caractéristique Description
codebase Required. Identifie l’emplacement, en tant qu’URI (Uniform Resource Identifier), du manifeste de déploiement utilisé pour mettre à jour l’application ClickOnce. Cet élément permet également de transférer des emplacements de mise à jour pour les installations basées sur CD. Doit être un URI valide.

Remarques

Vous pouvez configurer votre application ClickOnce pour rechercher les mises à jour au démarrage, rechercher les mises à jour après le démarrage ou ne jamais vérifier les mises à jour. Pour rechercher les mises à jour au démarrage, vérifiez que l’élément beforeApplicationStartup existe sous l’élément update . Pour rechercher les mises à jour après le démarrage, vérifiez que l’élément expiration existe sous l’élément update et que les intervalles de mise à jour sont fournis.

Pour désactiver la vérification des mises à jour, supprimez l’élément subscription . Lorsque vous spécifiez dans le manifeste de déploiement de ne jamais analyser les mises à jour, vous pouvez toujours rechercher manuellement les mises à jour à l’aide de la CheckForUpdate méthode.

Note

La classe ApplicationDeployment et les API de l’espace de noms System.Deployment.Application ne sont pas prises en charge dans .NET Core et .NET 5 et les versions ultérieures. Dans .NET 7, une nouvelle méthode d’accès aux propriétés de déploiement d’application est prise en charge. Pour plus d’informations, consultez les propriétés de déploiement Access ClickOnce dans .NET. .NET 7 ne prend pas en charge l’équivalent des méthodes ApplicationDeployment.

Pour plus d’informations sur la façon dont deploymentProvider est lié aux mises à jour, consultez Choisir une stratégie de mise à jour ClickOnce.

Exemples

L’exemple de code suivant illustre un deployment élément dans un manifeste de déploiement ClickOnce. L’exemple utilise un deploymentProvider élément pour indiquer l’emplacement de mise à jour par défaut.

<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>

Voir aussi

  • Dernière mise à jour :