Attività UpdateManifestForBrowserApplication

Articolo
08/11/2011

L'attività UpdateManifestForBrowserApplication viene eseguita per aggiungere l'elemento <hostInBrowser /> al manifesto dell'applicazione (nomeprogetto.exe.manifest) quando viene compilato un progetto XAML browser application (XBAP).

Parametri dell'attività

Parametro	Descrizione
ApplicationManifest	Parametro ITaskItem[] obbligatorio. Specifica il percorso e il nome del file manifesto dell'applicazione a cui si desidera aggiungere l'elemento <hostInBrowser />.
HostInBrowser	Parametro Boolean obbligatorio. Specifica se modificare il manifesto dell'applicazione per includere l'elemento <hostInBrowser />. Se true, un nuovo elemento <hostInBrowser /> verrà incluso nell'elemento <entryPoint />. L'inclusione degli elementi è cumulativa: se un elemento <hostInBrowser /> esiste già, non verrà rimosso o sovrascritto. Al contrario, verrà creato un elemento <hostInBrowser /> aggiuntivo. Se false, il manifesto dell'applicazione non verrà modificato.

ApplicationManifest

Parametro ITaskItem[] obbligatorio.

Specifica il percorso e il nome del file manifesto dell'applicazione a cui si desidera aggiungere l'elemento <hostInBrowser />.

HostInBrowser

Parametro Boolean obbligatorio.

Specifica se modificare il manifesto dell'applicazione per includere l'elemento <hostInBrowser />. Se true, un nuovo elemento <hostInBrowser /> verrà incluso nell'elemento <entryPoint />. L'inclusione degli elementi è cumulativa: se un elemento <hostInBrowser /> esiste già, non verrà rimosso o sovrascritto. Al contrario, verrà creato un elemento <hostInBrowser /> aggiuntivo. Se false, il manifesto dell'applicazione non verrà modificato.

Note

Le XBAPs vengono eseguite utilizzando la distribuzione ClickOnce e, pertanto, devono essere pubblicate con i manifesti di distribuzione e dell'applicazione di supporto. Microsoft build engine (MSBuild) utilizza l'attività GenerateApplicationManifest per generare un manifesto dell'applicazione.

Per configurare un'applicazione da ospitare in un browser, pertanto, è necessario aggiungere un ulteriore elemento <hostInBrowser /> al manifesto dell'applicazione, come illustrato nell'esempio seguente:

<!--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>
  ...
/>

L'attività UpdateManifestForBrowserApplication viene eseguita quando viene incorporato un progetto XBAP per aggiungere l'elemento <hostInBrowser />.

Esempio

Nell'esempio riportato di seguito viene illustrato come garantire che l'elemento <hostInBrowser /> venga incluso in un file manifesto dell'applicazione.

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