UpdateManifestForBrowserApplication 工作

發行項
08/21/2008

更新：2007 年 11 月

建置 XAML 瀏覽器應用程式 (XBAP) 專案時，會執行 UpdateManifestForBrowserApplication 工作，將 <hostInBrowser /> 項目加入到應用程式資訊清單 (projectname.exe.manifest)。

工作參數

參數	描述
ApplicationManifest	必要的 ITaskItem[] 參數。指定應用程式資訊清單檔案的路徑和名稱，以在檔案中加入 <hostInBrowser /> 項目。
HostInBrowser	必要的 Boolean 參數。指定是否要修改應用程式資訊清單，以加入 <hostInBrowser /> 項目。如果為 true，則會在 <entryPoint /> 項目中加入新的 <hostInBrowser /> 項目。請注意，加入的項目會累積：如果 <hostInBrowser /> 項目已存在，將不會移除或覆寫此項目，而會另外建立一個 <hostInBrowser /> 項目。若為 false，則不會修改應用程式資訊清單。

ApplicationManifest

必要的 ITaskItem[] 參數。

指定應用程式資訊清單檔案的路徑和名稱，以在檔案中加入 <hostInBrowser /> 項目。

HostInBrowser

必要的 Boolean 參數。

指定是否要修改應用程式資訊清單，以加入 <hostInBrowser /> 項目。如果為 true，則會在 <entryPoint /> 項目中加入新的 <hostInBrowser /> 項目。請注意，加入的項目會累積：如果 <hostInBrowser /> 項目已存在，將不會移除或覆寫此項目，而會另外建立一個 <hostInBrowser /> 項目。若為 false，則不會修改應用程式資訊清單。

備註

XBAP 是使用 ClickOnce 部署執行，因此必須藉由支援的部署和應用程式資訊清單發行。Microsoft Build Engine (MSBuild) 使用 GenerateApplicationManifest 工作產生應用程式資訊清單。

接著，若要設定應用程式裝載於瀏覽器，就必須將另一個項目 <hostInBrowser /> 加入到應用程式資訊清單，如下列範例所示：

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

UpdateManifestForBrowserApplication 工作會在建立 XBAP 專案時執行，以便加入 <hostInBrowser /> 項目。

範例

下列範例示範如何確保 <hostInBrowser /> 項目已加入到應用程式資訊清單檔案。

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