<deployment>, élément (Déploiement ClickOnce)

Article
08/21/2008

Mise à jour : novembre 2007

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

<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 de noms asmv2. L'élément possède les attributs suivants.

Attribut	Description
Install	Obligatoire. Spécifie si cette application définit une présence dans le menu Démarrer et dans l'application Ajout/Suppression de programmes du panneau de configuration. Les valeurs valides sont true et false. Si la valeur est false, ClickOnce exécutera toujours la version la plus récente de cette application à partir du réseau et ne reconnaîtra pas l'élément subscription.
minimumRequiredVersion	Facultatif. Spécifie la version minimale de cette application en mesure de 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 au format N.N.N.N, N représentant un entier non signé. Si l'attribut install a la valeur false, minimumRequiredVersion ne doit pas être défini.
mapFileExtensions	Facultatif. Les valeurs par défaut ont la valeur false. Si elles ont la valeur true, tous les fichiers dans le déploiement doivent posséder une extension .deploy. ClickOnce supprime l'extension de ces fichiers dès qu'il les télécharge à partir du serveur Web. Si vous publiez votre application à l'aide de Visual Studio, il ajoute automatiquement cette extension à tous les fichiers. Ce paramètre autorise tous les fichiers dans un déploiement de ClickOnce à être téléchargés à partir d'un serveur Web qui bloque la transmission des fichiers se terminant par des extensions « non sécurisées », telles que .exe.
disallowUrlActivation	Facultatif. Les valeurs par défaut ont la valeur false. Si la valeur est true, empêche une application installée de démarrer lorsque l'utilisateur clique sur l'URL ou entre l'URL dans Internet Explorer. Si l'attribut install n'est pas présent, cet attribut est ignoré.
trustUrlParameters	Facultatif. Les valeurs par défaut ont la valeur false. Si la valeur est true, permet à l'URL de contenir des paramètres de la chaîne de requête qui sont passés dans l'application, tout comme des arguments de ligne de commande sont passés à une application en mode ligne de commande. Pour plus d'informations, consultez Comment : récupérer les informations de chaîne de requête dans une application ClickOnce. Si l'attribut disallowUrlActivation a la valeur true, trustUrlParameters doit être exclu du manifeste ou explicitement défini sur la valeur false.

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

subscription

Facultatif. Contient l'élément update. L'élément subscription ne contient pas d'attributs. Si l'élément subscription n'existe pas, l'application ClickOnce ne vérifie jamais l'existence de mises à jour. Si l'attribut install de l'élément deployment a la valeur false, l'élément subscription est ignoré dans la mesure où une application ClickOnce lancée à partir du réseau utilise toujours la version la plus récente.

update

Obligatoire. Cet élément est un enfant de l'élément subscription et contient l'élément beforeApplicationStartup ou expiration. beforeApplicationStartup et expiration ne peuvent pas être tous les deux spécifiés dans le même manifeste de déploiement.

L'élément update ne contient pas d'attributs.

beforeApplicationStartup

Facultatif. Cet élément est un enfant de l'élément update et ne possède pas d'attributs. Lorsque l'élément beforeApplicationStartup existe, l'application est bloquée lorsque ClickOnce vérifie les mises à jour, si le client est en ligne. Si cet élément n'existe pas, ClickOnce commence par vérifier les mises à jour en fonction des valeurs spécifiées pour l'élément expiration. beforeApplicationStartup et expiration ne peuvent pas être tous les deux spécifiés dans le même manifeste de déploiement.

expiration

Facultatif. Cet élément est un enfant de l'élément update et n'a pas d'enfants. beforeApplicationStartup et expiration ne peuvent pas être tous les deux spécifiés dans le même manifeste de déploiement.

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

Attribut	Description
maximumAge	Obligatoire. Détermine l'âge que doit avoir la mise à jour actuelle pour que l'application exécute une vérification de mise à jour. L'unité de temps est déterminée par l'attribut unit.
unit	Obligatoire. Identifie l'unité de temps utilisée pour maximumAge. Les unités valides sont hours (heures), days (jours) et weeks (semaines).

deploymentProvider

Pour .NET Framework 2.0, requis si le manifeste de déploiement contient une section subscription ; sinon, facultatif. Pour .NET Framework 3.5, cet élément est facultatif et aura comme valeur par défaut le chemin d'accès au serveur et au fichier dans lequel le manifeste de déploiement a été trouvé.

Cet élément est un enfant de l'élément deployment et possède l'attribut suivant.

Attribut	Description
codeBase	Obligatoire. Identifie l'emplacement, sous la forme d'un identificateur URI (Uniform Resource Identifier), du manifeste de déploiement utilisé pour mettre à jour l'application ClickOnce. Cet élément permet également de transférer les emplacements de mise à jour pour les installations réalisées à partir de CD. Doit être un URI valide.

Notes

Vous pouvez configurer votre application ClickOnce pour vérifier les mises à jour au démarrage, vérifier les mises à jour après le démarrage ou ne jamais vérifier les mises à jour. Pour vérifier les mises à jour au démarrage, assurez-vous que l'élément beforeApplicationStartup existe sous l'élément update.

Pour vérifier les mises à jour après le démarrage, assurez-vous que l'élément expiration existe sous l'élément update et que les intervalles de mise à jour requis sont indiqués.

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 vérifier les mises à jour, vous pouvez néanmoins vérifier manuellement la présence de mises à jour à l'aide de la méthode CheckForUpdate.

Pour plus d'informations sur la façon dont le deploymentProvider est en rapport avec les mises à jour, consultez Choix d'une stratégie de mise à jour ClickOnce.

Exemples

L'exemple de code suivant illustre un élément deployment dans un manifeste de déploiement ClickOnce. L'exemple utilise un élément deploymentProvider pour indiquer l'emplacement de mise à jour par défaut. Cet exemple de code fait partie d'un exemple plus développé fourni dans la rubrique Manifeste de déploiement ClickOnce.

<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

Référence

Manifeste de déploiement ClickOnce

Partager via