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

Article
08/10/2011

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 urn:schemas-microsoft-com:asm.v1. 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 vrai, tous les fichiers dans le déploiement doivent avoir une extension .deploy. ClickOnce supprimera cette extension de ces fichiers après téléchargement à 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 en ligne. 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.

abonnement

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 spécifiées à la fois 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 recherchera en premier des mises à jour selon les valeurs spécifiées pour l'élément expiration. beforeApplicationStartup et expiration ne peuvent pas être spécifiées à la fois dans le même manifeste de déploiement.

expiration

Facultatif. Cet élément est un enfant de l'élément update, et ne possède pas d'enfants. beforeApplicationStartup et expiration ne peuvent pas être spécifiées à la fois dans le même manifeste de déploiement. Lorsque la vérification des mises à jour se produit et qu'une version mise à jour est détectée, la nouvelle version se met en cache pendant l'exécution de la version existante. La nouvelle version s'installe ensuite au prochain lancement de l'application ClickOnce.

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, cet élément est obligatoire si le manifeste de déploiement contient une section subscription. Pour la version 3.5 du .NET Framework et les versions ultérieures, cet élément est facultatif et aura comme valeur par défaut le chemin d'accès du serveur et du fichier où 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.

<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