élément <entryPoint> (application ClickOnce)

  • Article

Identifie l’assembly qui doit être exécuté lorsque cette application ClickOnce est exécutée sur un ordinateur client.

Syntax

<entryPoint
   name
>
   <assemblyIdentity
      name
      version
      processorArchitecture
      language
   />
   <commandLine
      file
      parameters
   />
   <customHostRequired />
   <customUX />
</entryPoint>

Éléments et attributs

L’élément entryPoint est obligatoire et se trouve dans l’espace de noms urn:schemas-microsoft-com:asm.v2 . Un seul élément entryPoint peut être défini dans un manifeste de l’application.

L’élément entryPoint comporte l’attribut suivant.

Attribut Description
name facultatif. Cette valeur n’est pas utilisée par .NET Framework.

entryPoint comporte les éléments suivants.

assemblyIdentity

Obligatoire. Le rôle de assemblyIdentity et ses attributs sont définis dans élément <assemblyIdentity>.

L’attribut processorArchitecture de cet élément et l’attribut processorArchitecture défini dans leassemblyIdentity ailleurs dans le manifeste de l’application doivent correspondre.

commandLine

Obligatoire. Doit être un enfant de l’élément entryPoint. Il n’a aucun élément enfant et a les attributs suivants.

Attribut Description
file Obligatoire. Référence locale à l’assembly de démarrage pour l’application ClickOnce. Cette valeur ne peut pas contenir de séparateurs de chemin de barre oblique (/) ou de barre oblique inverse (\).
parameters Obligatoire. Décrit l’action à entreprendre avec le point d’entrée. La seule valeur valide est run ; si une chaîne vide est fournie, run est adopté.

customHostRequired

facultatif. S’il est inclus, spécifie que ce déploiement contient un composant qui sera déployé à l’intérieur d’un hôte personnalisé et n’est pas une application autonome.

Si cet élément est présent, les éléments assemblyIdentity et commandLine ne doivent pas également être présents. Si c’est le cas, ClickOnce génère une erreur de validation lors de l’installation.

Cet élément n’a aucun attribut et aucun enfant.

customUX

facultatif. Spécifie que l’application est installée et gérée par un programme d’installation personnalisé et ne crée pas d’entrée de menu Démarrer, de raccourci ou d’ajout ou de suppression de programmes.

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

Une application qui inclut l’élément customUX doit fournir un programme d’installation personnalisé qui utilise la classe InPlaceHostingManager pour effectuer des opérations d’installation. Une application avec cet élément ne peut pas être installée en double-cliquant sur son manifeste ou son programme d’amorçage prérequis setup.exe. Le programme d’installation personnalisé peut créer des entrées de menu Démarrer, des raccourcis et des entrées Ajouter ou supprimer des programmes. Si le programme d’installation personnalisé ne crée pas d’entrée Ajouter ou supprimer des programmes, il doit stocker l’identificateur d’abonnement fourni par la propriété SubscriptionIdentity et permettre à l’utilisateur de désinstaller l’application ultérieurement en appelant la méthode UninstallCustomUXApplication. Pour plus d’informations, consultez Procédure pas à pas : création d’un programme d’installation personnalisé pour une application ClickOnce.

Remarques

Cet élément identifie l’assembly et le point d’entrée de l’application ClickOnce.

Vous ne pouvez pas utiliser commandLine pour transmettre des paramètres à votre application au moment de l’exécution. Vous pouvez accéder aux paramètres de chaîne de requête pour un déploiement ClickOnce à partir de AppDomain dans l’application. Pour en savoir plus, consultez Guide pratique pour récupérer les informations de chaîne de requête dans une application ClickOnce en ligne.

Exemple

L’exemple de code suivant illustre un élément entryPoint dans un manifeste d’application pour une application ClickOnce. Cet exemple de code fait partie d’un exemple plus étoffé fourni pour la rubrique Manifeste d’application ClickOnce.

<!-- Identify the main code entrypoint. -->
<!-- This code runs the main method in an executable assembly. -->
  <entryPoint>
    <assemblyIdentity
      name="MyApplication"
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>

Voir aussi