UpdateManifestForBrowserApplication, tâche

Article
06/09/2015

La tâche UpdateManifestForBrowserApplication est exécutée pour ajouter l'élément <hostInBrowser /> au manifeste d'application (nomprojet.exe.manifest) lorsqu'un projet application du navigateur XAML (XBAP) est généré.

Paramètres de la tâche

Paramètre	Description
ApplicationManifest	Paramètre ITaskItem[] obligatoire. Spécifie le chemin d'accès et le nom du fichier manifeste d'application que vous souhaitez ajouter à l'élément <hostInBrowser />.
HostInBrowser	Paramètre Boolean obligatoire. Spécifie s'il faut modifier le manifeste d'application pour y inclure l'élément <hostInBrowser />. Si la valeur est true, un nouvel élément <hostInBrowser /> est inclus dans l'élément <entryPoint />. Notez que le fait d'inclure cet élément est un processus cumulatif : si un élément <hostInBrowser /> existe déjà, il n'est ni supprimé ni remplacé. Un élément <hostInBrowser /> supplémentaire est créé à la place. Si la valeur est false, le manifeste d'application n'est pas modifié.

ApplicationManifest

Paramètre ITaskItem[] obligatoire.

Spécifie le chemin d'accès et le nom du fichier manifeste d'application que vous souhaitez ajouter à l'élément <hostInBrowser />.

HostInBrowser

Paramètre Boolean obligatoire.

Spécifie s'il faut modifier le manifeste d'application pour y inclure l'élément <hostInBrowser />. Si la valeur est true, un nouvel élément <hostInBrowser /> est inclus dans l'élément <entryPoint />. Notez que le fait d'inclure cet élément est un processus cumulatif : si un élément <hostInBrowser /> existe déjà, il n'est ni supprimé ni remplacé. Un élément <hostInBrowser /> supplémentaire est créé à la place. Si la valeur est false, le manifeste d'application n'est pas modifié.

Notes

Les XBAP sont exécutées à l'aide du déploiement ClickOnce et doivent, par conséquent, être publiées avec des manifestes de déploiement et d'application pris en charge. Microsoft Build Engine (MSBuild) utilise la tâche GenerateApplicationManifest pour générer un manifeste d'application.

Ensuite, pour configurer une application hébergée par un navigateur, vous devez ajouter un élément supplémentaire au manifeste d'application, soit <hostInBrowser />, comme indiqué dans l'exemple suivant :

<!--MyXBAPApplication.exe.manifest-->
<?xml version="1.0" encoding="utf-8"?>
<asmv1:assembly ... >
    <asmv1:assemblyIdentity ... />
    <application />
    <entryPoint>
      ...
      <hostInBrowser xmlns="urn:schemas-microsoft-com:asm.v3" />
    </entryPoint>
  ...
/>

La tâche UpdateManifestForBrowserApplication est exécutée lorsqu'un projet XBAP est généré pour ajouter l'élément <hostInBrowser />.

Exemple

L'exemple suivant indique comment garantir que l'élément <hostInBrowser /> est inclus dans un fichier manifeste d'application.

<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <UsingTask 
    TaskName="Microsoft.Build.Tasks.Windows.UpdateManifestForBrowserApplication"
    AssemblyFile="C:\Program Files\Reference Assemblies\Microsoft\Framework\v3.0\PresentationBuildTasks.dll" />
  <Target Name="UpdateManifestForBrowserApplicationTask">
    <UpdateManifestForBrowserApplication
      ApplicationManifest="MyXBAPApplication.exe.manifest"
      HostInBrowser="true" />
  </Target>
</Project>