Office ソリューション用アプリケーションマニフェスト

[アーティクル]
08/09/2011

アプリケーションマニフェストは、Microsoft Office ソリューションに読み込まれるアセンブリについて記述した XML ファイルです。 Visual Studio の Microsoft Office 開発ツールでは ClickOnce アプリケーションマニフェストスキーマを使用します。このスキーマは、「ClickOnce アプリケーションマニフェスト」で定義されています。

Office ソリューション用のアプリケーションマニフェストは、次の ClickOnce 要素および属性を使用します。

要素	説明	属性
<assembly> 要素 (ClickOnce アプリケーション)	必ず指定します。最上位の要素です。	manifestVersion
<assemblyIdentity> 要素 (ClickOnce アプリケーション)	必ず指定します。 ClickOnce アプリケーションのプライマリアセンブリを指定します。	name version publicKeyToken processorArchitecture language
<trustInfo> 要素 (ClickOnce アプリケーション)	アプリケーションのセキュリティ要件を指定します。	なし
<entryPoint> 要素 (ClickOnce アプリケーション)	必ず指定します。アプリケーションコードを実行するためのエントリポイントを指定します。	name dependencyName customHostSpecified
<dependency> 要素 (ClickOnce アプリケーション)	必ず指定します。アプリケーションを実行するために必要な依存関係をそれぞれ指定します。必要な場合には、プレインストールしなければならないアセンブリを指定します。	なし
<file> 要素 (ClickOnce アプリケーション)	必ず指定します。アプリケーションで使用する、アセンブリ以外のファイルを指定します。ファイルに関連付けられている分離COM (Component Object Model) コンポーネントを含めることができます。	name size

Office ソリューション用アプリケーションマニフェストには、co.v1 名前空間の次の要素があります。

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

これらのアプリケーションマニフェストには、vstav3 名前空間の次の要素と属性もあります。

<addIn>
  <entryPointsCollection>
    <entryPoints>
      <entryPoint>
      </entryPoint>
    </entryPoints>
  </entryPointsCollection>
  <update></update>
  <postActions>
    <postAction>
      <postActionData>
      </postActionData>
    <postAction>
  </postActions>
  <application>
    <customizations>
      <customization>
      </customization>
    </customizations>
  </application
</addIn>

要素	説明	属性
<customHostSpecified> 要素 (Visual Studio での Office 開発)	必ず指定します。マニフェストを Office ソリューションとして明確にマークします。	なし
<addin> 要素 (Visual Studio での Office 開発)	必ず指定します。エントリポイントを単一の名前空間に格納します。	なし
<entryPointsCollection> 要素 (Visual Studio での Office 開発)	必ず指定します。 1 つ以上の Office ソリューション用のすべてのアセンブリをグループ化します。	id
<entryPoints> 要素 (Visual Studio での Office 開発)	必ず指定します。 Office ソリューションを実行するためのすべてのアセンブリをグループ化します。	なし
<entryPoint> 要素 (Visual Studio での Office 開発)	必ず指定します。 Office ソリューションで実行するためのアセンブリを識別します。	class contract
<update> 要素 (Visual Studio での Office 開発)	必ず指定します。ソリューションの更新を構成します。	enabled expiration
<postActions> 要素 (Visual Studio での Office 開発)	省略可能です。 Office ソリューションのインストール後に実行される、すべての配置後アクションをグループ化します。	なし
<postAction> 要素 (Visual Studio での Office 開発)	省略可能です。配置後アクションを識別します。	なし
<postActionData> 要素 (Visual Studio での Office 開発)	省略可能です。配置後アクション用にデータを構成します。	なし
<application> 要素 (Visual Studio での Office 開発)	必ず指定します。アプリケーション固有の情報を単一のノードにラップします。	なし
<customizations> 要素 (Visual Studio での Office 開発)	必ず指定します。アプリケーションホスト固有のすべての情報を個別の名前空間に格納します。	なし
<customization> 要素 (Visual Studio での Office 開発)	必ず指定します。アプリケーションホスト固有の情報を個別の名前空間に格納します。	xmlns
<document> 要素 (Visual Studio での Office 開発)	ドキュメントレベルのソリューションでのみ必須です。カスタマイズ固有の情報を格納します。	solutionId
<appAddin> 要素 (Visual Studio での Office 開発)	アプリケーションレベルのソリューションでのみ必須です。カスタマイズ固有の情報を格納します。	application loadBehavior keyName
<friendlyName> 要素 (Visual Studio での Office 開発)	省略可能です。インストールされているアドインの一覧に表示されるアドインの名前を格納します。	なし
<description> 要素 (Visual Studio での Office 開発)	アプリケーションレベルのアドインでのみ必須です。インストールされているプログラムの一覧に表示される説明を格納します。	なし
<formRegions> 要素 (Visual Studio での Office 開発)	フォーム領域を含んでいる Outlook 2007 アドインでのみ必須です。	なし
<formRegion> 要素 (Visual Studio での Office 開発)	フォーム領域を含んでいる Outlook 2007 アドインでのみ必須です。	Name
<vstoRuntime> 要素 (Visual Studio での Office 開発)	必ず指定します。 Office ソリューションがサポートする、Visual Studio Tools for Office ランタイムの特定のバージョンを記述します。	release version supportUrl

解説

Office ソリューションのアプリケーションマニフェストと配置マニフェストは、手動で編集できます。アプリケーションマニフェストと配置マニフェストを編集した後は、マニフェストの生成および編集ツール (mage.exe および mageui.exe) を使用して再署名する必要があります。詳細については、「方法: アプリケーションマニフェストおよび配置マニフェストに再署名する」を参照してください。

ファイルの場所

アプリケーションマニフェストは単一のバージョンのソリューションに特有のものです。このため、アプリケーションマニフェストは、配置マニフェストとは別の場所に格納する必要があります。 Visual Studio は、バージョン固有のファイルを、発行フォルダーの Application Files サブディレクトリ内の対応するバージョンに基づいて名前を付けられたサブディレクトリに格納します。

ファイル名の構文

アプリケーションマニフェストファイルの名前は、assemblyIdentity 要素に指定されたアプリケーションの完全な名前および拡張子に、.manifest という拡張子を付けた名前にします。たとえば、OutlookAddIn1.dll カスタマイズを参照するアプリケーションマニフェストは、次のようなファイル名構文を使用します。

OutlookAddIn1.dll.manifest

ドキュメントレベルのカスタマイズの例

説明

次のコード例は、Visual Studio Tools for Office ソリューションに固有のアプリケーションマニフェストのセクションを示しています。この例では、Microsoft Office Excel 2007 のドキュメントレベルのカスタマイズを記述しています。

コード

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.ThisWorkbook">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet1">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet2">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet3">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:document 
          solutionId="73e" />
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

アプリケーションレベルのアドインの例

説明

次のコード例は、Visual Studio Tools for Office ソリューションに固有のアプリケーションマニフェストのセクションを示しています。この例では、フォーム領域を含む Microsoft Office Outlook 2007 のアプリケーションレベルのアドインを記述しています。

コード

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoOutlookAddIn.ThisAddIn">
        <assemblyIdentity 
          name="ContosoOutlookAddIn" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook add-in 
            created with Visual Studio Tools for Office
          </vstov4:description>
          <vstov4:formRegions>
            <vstov4:formRegion
                name="OutlookAddIn1.FormRegion1">
              <vstov4:messageClass name="IPM.Note" />
              <vstov4:messageClass name="IPM.Contact" />
              <vstov4:messageClass name="IPM.Appointment" />
            </vstov4:formRegion>
          </vstov4:formRegions>
        </vstov4:appAddIn>
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

複数プロジェクトの配置例

説明

次のコード例は、Visual Studio Tools for Office ソリューションに固有のアプリケーションマニフェストのセクションを示しています。この例では、フォーム領域を含む Microsoft Outlook 2007 のアプリケーションレベルのアドインと、Microsoft Excel 2007 のドキュメントレベルのカスタマイズをインストールする、複数プロジェクトの配置を記述しています。

コード

  <entryPoint>
    <co.v1:customHostSpecified />
  </entryPoint>
[...]
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoExcelWorkbook.dll" 
      size="12800">
      <assemblyIdentity 
        name="ContosoExcelWorkbook" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>ONF</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoOutlookAddIn.dll" 
      size="10240">
      <assemblyIdentity 
        name="ContosoOutlookAddIn" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>i4e</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <vstav3:addIn 
    xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
    <vstav3:entryPointsCollection>
      <vstav3:entryPoints 
        id="ContosoExcel">
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.ThisWorkbook">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet1">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet2">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet3">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
      <vstav3:entryPoints 
        id="ContosoOutlook">
        <vstav3:entryPoint 
          class="ContosoOutlookAddIn.ThisAddIn">
          <assemblyIdentity 
            name="ContosoOutlookAddIn" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
    </vstav3:entryPointsCollection>
    <vstav3:update 
      enabled="true">
      <vstav3:expiration 
        maximumAge="7" 
        unit="days" />
    </vstav3:update>
    <vstav3:application>
      <vstov4:customizations 
        xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
        <vstov4:customization 
          id="ContosoExcel">
          <vstov4:document 
            solutionId="73ec4ba9-a983-40b3-af63-5fb172ea81db" />
        </vstov4:customization>
        <vstov4:customization 
          id="ContosoOutlook">
          <vstov4:appAddIn 
            application="Outlook" 
            loadBehavior="3" 
            keyName="ContosoOutlookAddIn">
            <vstov4:friendlyName>
              ContosoOutlookAddIn
            </vstov4:friendlyName>
            <vstov4:description>
              ContosoOutlookAddIn - Outlook add-in created with 
              Visual Studio Tools for Office
            </vstov4:description>
          </vstov4:appAddIn>
        </vstov4:customization>
      </vstov4:customizations>
    </vstav3:application>
  </vstav3:addIn>

配置後アクションの例

説明

次のコード例は、Visual Studio Tools for Office ソリューションに固有のアプリケーションマニフェストのセクションを示しています。この例では、インストール完了後にレジストリキーを作成する配置後アクションを記述しています。

コード

<vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint 
      class="PostDeploymentAction.PostDeploymentActionSample">
      <assemblyIdentity 
        name="PostDeploymentAction" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

参照

Office ソリューション用配置マニフェスト

ClickOnce アプリケーションマニフェスト

次の方法で共有

Office ソリューション用アプリケーションマニフェスト

解説

ファイルの場所

ファイル名の構文

ドキュメントレベルのカスタマイズの例

説明

コード

アプリケーションレベルのアドインの例

説明

コード

複数プロジェクトの配置例

説明

コード

配置後アクションの例

説明

コード

参照

参照

その他のリソース

次の方法で共有

Office ソリューション用アプリケーション マニフェスト

解説

ファイルの場所

ファイル名の構文

ドキュメント レベルのカスタマイズの例

説明

コード

アプリケーション レベルのアドインの例

説明

コード

複数プロジェクトの配置例

説明

コード

配置後アクションの例

説明

コード

参照

参照

その他のリソース

Office ソリューション用アプリケーションマニフェスト

ドキュメントレベルのカスタマイズの例

アプリケーションレベルのアドインの例