Office ソリューション用アプリケーション マニフェスト
アプリケーション マニフェストは、Microsoft Office ソリューションに読み込まれるアセンブリについて記述した XML ファイルです。 Visual Studio の Microsoft Office 開発ツールは、ClickOnce アプリケーション マニフェスト リファレンスで定義されている ClickOnce アプリケーション マニフェスト スキーマを使います。
Office ソリューション用のアプリケーション マニフェストは、次の ClickOnce 要素と属性を使います。
| 要素 | 説明 | 属性 |
|---|---|---|
| <[assembly]> 要素 (ClickOnce アプリケーション) | 必須。 最上位の要素です。 | manifestVersion |
| <[assemblyIdentity]> 要素 (ClickOnce アプリケーション) | 必須。 ClickOnce アプリケーションのプライマリ アセンブリを識別します。 | name version publicKeyToken processorArchitecture 言語 |
| <[trustInfo]> 要素 (ClickOnce アプリケーション) | アプリケーションのセキュリティ要件を識別します。 | なし |
| <[entryPoint]> 要素 (ClickOnce アプリケーション) | 必須。 実行用のアプリケーション コードのエントリ ポイントを識別します。 | name dependencyName customHostSpecified |
| <[dependency]> 要素 (ClickOnce アプリケーション) | 必須。 アプリケーションを実行するために必要な依存関係をそれぞれ識別します。 任意で、プレインストールする必要のあるアセンブリを識別します。 | なし |
| <[file]> 要素 (ClickOnce アプリケーション) | 必須。 アプリケーションで使用する、アセンブリ以外の各ファイルを指定します。 ファイルに関連付けられているコンポーネント オブジェクト モデル (COM) 分離データを含めることができます。 | 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 ソリューションで実行するためのアセンブリを識別します。 | クラス contract |
| <[update]> 要素 (Visual Studio の Office 開発) | 必須。 ソリューションの更新を構成します。 | 有効 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 開発) | 省略可能。 インストールされている VSTO アドインの一覧に表示される VSTO アドインの名前を格納します。 | なし |
| <[description]> 要素 (Visual Studio の Office 開発) | VSTO アドインでのみ必須です。インストールされているプログラムの一覧に表示される説明を格納します。 | なし |
| <[formRegions]> 要素 (Visual Studio の Office 開発) | フォーム領域を含んでいる Outlook VSTO アドインでのみ必須です。 | なし |
| <[formRegion]> 要素 (Visual Studio の Office 開発) | フォーム領域を含んでいる Outlook VSTO アドインでのみ必須です。 | 名前 |
| <[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