UpdateManifestForBrowserApplication タスク

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

UpdateManifestForBrowserApplication タスクは、XAML ブラウザアプリケーション (XBAP) プロジェクトのビルド時に、アプリケーションマニフェスト (projectname.exe.manifest) に <hostInBrowser /> 要素を追加するために実行されます。

タスクパラメータ

パラメータ	説明
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 ビルドエンジン (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>
  ...
/>

<hostInBrowser /> 要素を追加するためには、XBAP プロジェクトのビルド時に、UpdateManifestForBrowserApplication タスクを実行します。

使用例

アプリケーションマニフェストファイルに <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>