UpdateManifestForBrowserApplication-Aufgabe

Artikel
08/10/2011

Die UpdateManifestForBrowserApplication-Aufgabe wird ausgeführt, um das <hostInBrowser />-Element zum Anwendungsmanifest (Projektname.exe.manifest) hinzuzufügen, wenn ein XAML browser application (XBAP)-Projekt erstellt wird.

Aufgabenparameter

Parameter	Beschreibung
ApplicationManifest	Erforderlicher ITaskItem[]-Parameter. Gibt den Pfad und den Namen der Anwendungsmanifestdatei an, zu der das <hostInBrowser />-Element hinzugefügt werden soll.
HostInBrowser	Erforderlicher Boolean-Parameter. Gibt an, ob das Anwendungsmanifest geändert werden soll, sodass es das <hostInBrowser />-Element enthält. Bei true wird ein neues <hostInBrowser />-Element in das <entryPoint />-Element aufgenommen. Beachten Sie, dass das Aufnehmen von Elementen kumulativ ist: Wenn bereits ein <hostInBrowser />-Element vorhanden ist, wird es weder entfernt noch überschrieben. Stattdessen wird ein weiteres <hostInBrowser />-Element erstellt. Bei false wird das Anwendungsmanifest nicht geändert.

ApplicationManifest

Erforderlicher ITaskItem[]-Parameter.

Gibt den Pfad und den Namen der Anwendungsmanifestdatei an, zu der das <hostInBrowser />-Element hinzugefügt werden soll.

HostInBrowser

Erforderlicher Boolean-Parameter.

Gibt an, ob das Anwendungsmanifest geändert werden soll, sodass es das <hostInBrowser />-Element enthält. Bei true wird ein neues <hostInBrowser />-Element in das <entryPoint />-Element aufgenommen. Beachten Sie, dass das Aufnehmen von Elementen kumulativ ist: Wenn bereits ein <hostInBrowser />-Element vorhanden ist, wird es weder entfernt noch überschrieben. Stattdessen wird ein weiteres <hostInBrowser />-Element erstellt. Bei false wird das Anwendungsmanifest nicht geändert.

Hinweise

XBAPs werden per ClickOnce-Bereitstellung ausgeführt und müssen daher mit unterstützenden Bereitstellungs- und Anwendungsmanifesten veröffentlicht werden. Microsoft build engine (MSBuild) verwendet die GenerateApplicationManifest-Aufgabe, um ein Anwendungsmanifest zu generieren.

Anschließend muss zum Konfigurieren einer Anwendung, die von einem Browser gehostet werden soll, dem Anwendungsmanifest ein weiteres <hostInBrowser />-Element hinzugefügt werden, wie im nachfolgenden Beispiel gezeigt wird:

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

Die UpdateManifestForBrowserApplication-Aufgabe wird ausgeführt, wenn ein XBAP-Projekt erstellt wird, um das <hostInBrowser />-Element hinzuzufügen.

Beispiel

Das folgende Codebeispiel zeigt, wie sichergestellt wird, dass das <hostInBrowser />-Element in eine Anwendungsmanifestdatei eingeschlossen wird.

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