Windows インストーラーを使用した Office ソリューションの配置

[アーティクル]
03/22/2013

Visual Studio 2012を使用して Office 2013 または Office 2010 のソリューションの Windows インストーラーファイル (.msi) を作成する方法を学習します。

Windows インストーラーファイルを作成するために Visual Studio 2012 を使用してエンドユーザーのコンピューターの管理アクセスを必要とする Office 2013 または Office 2010 のソリューションを配置できます。たとえば、ソリューションのコンピューターのユーザーは一度だけインストールするには、このファイルを使用できます。また、ClickOnce を使用して Office ソリューションを配置すると、そのソリューションは、コンピューターのユーザーごとに個別にインストールする必要があります。

Windows インストーラーの配置に ClickOnce の配置の違いの一覧を表示するには、配置ストラテジの選択を参照してください。

このトピックの内容

サンプルをダウンロードします。
InstallShield に制限バージョンを取得します。
ソリューションに信頼を付与する方法を決定します。
セットアッププロジェクトを作成します。
プロジェクト出力を追加します
配置マニフェストおよびアプリケーションマニフェストを追加します。
必須コンポーネントとして依存コンポーネントを構成します。
ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。
Configure an add-in
ドキュメントレベルのカスタマイズを構成します。
セットアッププロジェクトをビルド

ClickOnce を使用して Office ソリューションを配置する方法の詳細については、ClickOnce を使用した Office ソリューションの配置を参照してください。

Visual Studio 2010を使用して、Windows インストーラーファイルを作成する方法の詳細については、" "を参照してください。Windows インストーラーを使用して Office ソリューションの Visual Studio 2010 Tools の配置

サンプルをダウンロードします。

このトピックでは、次のダウンロード可能なサンプルを示します。

サンプル	説明
ExcelAddIn	、Office 32 ビットまたは 64 ビットバージョンを実行しているコンピューターにインストールできます。Excel アドイン。
[ExcelWorkbook]	、Office 32 ビットまたは 64 ビットバージョンを実行しているコンピューターにインストールできます。Excel のドキュメントレベルのカスタマイズ。

ソリューションに信頼を付与する方法を決定します。

ソリューションがユーザーのコンピューターで実行する前に、次の方法で信頼を付与するソリューションをインストールするユーザーは、信頼プロンプトに応答する必要があります。

既知の信頼される発行者を特定する証明書を使用してマニフェストに署名します。詳細については、「ソリューションのアプリケーションマニフェストと配置マニフェストの署名によって信頼します」を参照してください。
ユーザーのコンピューターの Program Files ディレクトリにソリューションをインストールします。

[!メモ]

ドキュメントレベルのカスタマイズでは、ドキュメントの位置は、信頼する必要があります。詳細については、「ドキュメントへの信頼の付与」を参照してください。

InstallShield に制限バージョンを取得します。

Visual Studio のインストールを自由に変更できる InstallShield Limited Edition (ISLE) を使用して、Windows インストーラーファイルを作成できます。アイランドは、以前のバージョンの Visual Studio が指定したセットアップおよび配置プロジェクトテンプレートの機能を置き換えます。

InstallShield に制限バージョンを取得するには

メニューバーで [ファイル]、[新規]、[プロジェクト] の順にクリックします。

[新しいプロジェクト] ダイアログボックスが表示されます。
テンプレートペインで、[その他のプロジェクトの種類] を展開し、[セットアップと配置] テンプレートを選択します。
[セットアップと配置] のプロジェクトの種類の一覧で、[InstallShield Limited Edition の有効化] を選択し、[OK] のボタンをクリックします。

InstallShield に制限バージョンを取得する方法に関する情報を提供するページが表示されます。
このページで、[Go to the download web site] のリンクを選択します。
InstallShield Limited Edition のダウンロードページで、必要な情報を適切なフィールドに入力し、を [Download Now] のリンクを選択します。

製品をダウンロードし、インストール、およびアクティブにすると、[InstallShield Limited Edition Project] テンプレートが Visual Studio に表示されます。

セットアッププロジェクトを作成します。

Visual Studioで、配置する Office プロジェクトを開きます。

このトピックに関連付けられたアプリケーションレベルのアドインの例では ExcelAddIn という名前のプロジェクトが含まれています。ドキュメントレベルのカスタマイズの例では ExcelWorkbook という名前のプロジェクトが含まれています。ここでは、これらの二つの名前の 1 つがを使用してソリューション内で Office プロジェクトを示します。
メニューバーで [ファイル] をクリックし、[追加] を選択し、[新しいプロジェクト] をクリックします。

[新しいプロジェクトの追加] のダイアログボックスが表示されます。
テンプレートペインで、[その他のプロジェクトの種類] を展開し、[セットアップと配置] テンプレートを選択します。
[セットアップと配置] のプロジェクトの種類の一覧で、[InstallShield Limited Edition Project] を選択し、プロジェクトの名前を入力し、を [OK] のボタンをクリックします。

作成した InstallShield のセットアッププロジェクトは、ソリューションに表示されます。

このトピックの例では [OfficeAddInSetup] という名前のセットアップのプロジェクトが含まれています。このトピックでは、同じ名前を使用して、ソリューションにセットアッププロジェクトを示します。

プロジェクト出力を追加します

Offce プロジェクトの出力を含む [OfficeAddInSetup] プロジェクトを構成します。アプリケーションレベルのアドインプロジェクトでは、プロジェクト出力は、ソリューションアセンブリだけです。ドキュメントレベルのカスタマイズプロジェクトでは、プロジェクト出力は、ソリューションのアセンブリまたはドキュメント自体だけでなく、含まれています。

プロジェクト出力を追加するには

[ソリューションエクスプローラー] では、[OfficeAddInSetup] のプロジェクトノードを展開し、次の図に示す [Project Assistant] ファイルを選択します。
メニューバーで、[ビュー]、[開く] を選択します。
[Project assistant] ページの下部に、次の図に示す [アプリケーションファイル] のボタンを選択します。
[アプリケーションファイル] のページで、[プロジェクト出力の追加] のボタンをクリックします。
[Visual Studio Output Selector] ]ダイアログボックスで、[プライマリ出力] のチェックボックスをオンにし、[OK] のボタンをクリックします。

配置マニフェストおよびアプリケーションマニフェストを追加します。

[アプリケーションファイル] のページで、[ファイルの追加] のボタンをクリックします。
[開く] のダイアログボックスで、ExcelAddIn プロジェクトの出力ディレクトリを参照します。

通常、出力ディレクトリは、選択したビルド構成によって、プロジェクトのルートディレクトリの bin\release のサブフォルダーです。
出力ディレクトリで、ExcelAddIn.dll.manifest の [ExcelAddIn.vsto] またはファイルを選択し、[開く] のボタンをクリックします。

[アプリケーションファイル] のページは次の図のように、プロジェクトの出力ファイル、配置マニフェストとアプリケーションマニフェストが含まれます。

必須コンポーネントとして依存コンポーネントを構成します。

セットアッププロジェクトのアプリケーションでは、次のコンポーネントがソリューションを実行するのに必要な他のコンポーネントがだけでなく、含める必要がありますが、

.NET Framework のバージョン、の Office ソリューションのターゲット。
Office ランタイムの Microsoft Visual Studio 2010 Tools。

必要条件として .NET Framework 4 または .NET Framework 4.5 を追加します

[ソリューションエクスプローラー] では、[OfficeAddInSetup] のプロジェクトノードを展開し、[Specify Application Data] のノードを展開し、次の図に示す [再頒布可能ファイル] ファイルを選択します。
メニューバーで、[ビュー]、[開く] を選択します。

[再頒布可能ファイル] のページが開きます。
の再頒布可能コンポーネントの一覧で .NET Framework Version のチェックボックスをそのソリューションのターゲット割り当てます。

たとえば、ソリューションに .NET Framework 4.5を対象とする場合は、[Microsoft .NET Framework 4.5 Full] のチェックボックスをオンにします。ダイアログボックスでは、必須コンポーネントとしてコンポーネントを追加する前に、InstallShield に必要な再頒布可能コンポーネントをインストールするかどうかを確認する可能性があります。このダイアログボックスが表示されない場合は、コンポーネントがコンピューターに存在します。
このダイアログボックスが表示された場合は、再頒布可能コンポーネントをダウンロードするには ○ のボタンをクリックします。

[!メモ]

エラーメッセージは、ダウンロードが失敗したことを示す場合があります。通常、このエラーは無視してかまいません。正常にファイルをダウンロードしたかどうかを確認するには、コンピューターの次のディレクトリを参照する:

32 ビットオペレーティングシステムの場合: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\Microsoft.net\ の[バージョン]の\のFullOrClientの\

64 ビットオペレーティングシステムの場合: %ProgramFiles (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\Microsoft.net\ の[バージョン]の\のFullOrClientの\

ファイルがそれらのディレクトリにない場合は、ダウンロードし、適切なディレクトリに設定する必要があります。

.NET Framework 4 をダウンロードするには、" "を参照してください https://download.microsoft.com/download/9/5/A/95A9616B-7A37-4AF6-BC36-D6EA96C8DAAE/dotNetFx40_Full_x86_x64.exe

.NET Framework 4 Client をダウンロードするには、" "を参照してください https://download.microsoft.com/download/5/6/2/562A10F9-C9F4-4313-A044-9C94E0A8FAC8/dotNetFx40_Client_x86_x64.exe

.NET Framework 4.5 をダウンロードするには、" "を参照してください https://download.microsoft.com/download/b/a/4/ba4a7e71-2906-4b2d-a0e1-80cf16844f5f/

[!メモ]

[再頒布可能ファイル] のページに一覧表示されている任意の必須コンポーネントの URL を検索するには、コンピューターの\InstallShield\2012SpringLE\SetupPrerequisites\ %ProgramFiles%のディレクトリの適切な .prq ファイルを開きます。各 .prq ファイルでは、URL が、<file> の要素の URL の属性に表示されます。

Office ランタイムの Visual Studio 2010 Tools を追加します。

[再頒布可能ファイル] のページは [Microsoft VSTO 2010 Runtime] という名前のが、実行時の古いバージョンを示します項目が含まれます。したがって、手動で最新バージョンを示す構成ファイルを作成する必要があります。[再頒布可能ファイル] のページに表示されるほかの項目のすべての構成ファイルと同じディレクトリにそのファイルを入力する必要があります。

Office ランタイムの Visual Studio 2010 Tools を必須コンポーネントとして追加するには

メモ帳をテキストファイルに、次の XML を貼り付けて。

<?xml version="1.0" encoding="UTF-8"?>
<SetupPrereq>
<conditions>
    <condition Type="32" Comparison="2" Path="HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4R" FileName="Version" ReturnValue="10.0.40303" Bits="2"></condition>
</conditions>
<files>
    <file LocalFile="&lt;ISProductFolder&gt;\SetupPrerequisites\VSTOR\vstor_redist.exe" URL="https://go.microsoft.com/fwlink/?LinkId=140384" CheckSum="b6639489e159b854b6dc43d5cb539043" FileSize="0,40023024"></file>
</files>
<execute file="vstor_redist.exe" returncodetoreboot="1641,3010" requiresmsiengine="1">
</execute>
<properties Id="Your GUID goes here" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." >
</properties>

</SetupPrereq>

コンピューターに [GUID ジェネレーター] のプログラムを使用して GUID を生成します。

コンピューターの [GUID ジェネレーター] のプログラムを検索するには、検索ボックスの [開始] のメニューおよび型 [GUID ジェネレーター] を開きます。
[GUID ジェネレーター] のプログラムでは、[Registry Format] のオプションボタンをクリックし、[コピー] のボタンを選択し、を [終了] のボタンをクリックします。

メモ帳で、代わりに GUID を貼り付けることでテキスト Your GUID goes here を置き換えます。

は、ファイルの <properties> の要素は次のようになります。

<properties Id="{87989B73-21DC-4403-8FD1-0C68A41A6D8C}" Description="This prerequisite installs the most recent version of the Microsoft Visual Studio 2010 Tools for Office Runtime." >
</properties>

メモ帳のメニューバーで、[ファイル]、[保存] を選択します。
[名前を付けて保存] のダイアログボックスで、[デスクトップ] のフォルダーに移動します。
[保存の種類] の一覧で、[All Files (*.*)] (*.*) ]を選択します。
[ファイル名] ボックスに、Office Runtime.prq の Visual Studio 2010 Toolsを入力し、を [保存] のボタンをクリックします。

[!メモ]

必要なファイルとしてこのファイルを識別するファイル名の末尾に [.prq] を追加してください。
メモ帳を閉じます。
[デスクトップ] のフォルダーから、コンピューターの次のディレクトリの 1 に Office Runtime.prq ファイルの Visual Studio 2010 Tools をコピーします。

32 ビットオペレーティングシステムの場合: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\

64 ビットオペレーティングシステムの場合: %ProgramFiles (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\
InstallShield プロジェクトの [Redistributable] のページでは、次の図に示すように、再頒布可能コンポーネントのリストを更新するには [最新の情報に更新] のボタンをクリックします。
再頒布可能コンポーネントの一覧で、[Visual Studio 2010 Tools for Office Runtime] のチェックボックスをオンにします。

ダイアログボックスが再頒布可能コンポーネントをインストールするかどうかを確認する可能性があります。このダイアログボックスが表示されない場合は、このトピックの" ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。のセクションに進むことができます。
このダイアログボックスが表示された場合は、再頒布可能コンポーネントをダウンロードするには ○ のボタンをクリックします。

[!メモ]

エラーメッセージは、ダウンロードが失敗したことを示す場合があります。このエラーを無視できます。正常にファイルをダウンロードしたかどうかを確認するには、コンピューターの次のディレクトリを参照する:

32 ビットオペレーティングシステムの場合: %ProgramFiles%\InstallShield\2012SpringLE\SetupPrerequisites\ VSTOR\

64 ビットオペレーティングシステムの場合: %ProgramFiles (x86) %\InstallShield\2012SpringLE\SetupPrerequisites\ VSTOR\

重要
InstallShield は、ランタイムの古いバージョンをダウンロードする場合があります。最新バージョンであることを確認するには、から Microsoft ダウンロードセンターOffice ランタイムの Visual Studio 2010 Tools の最新バージョンをダウンロードし、適切なディレクトリに設定します。

ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。

[ソリューションエクスプローラー] では、[OfficeAddInSetup] のノードを展開し、[Organize your Setup] のノードを展開し、を [一般情報] のファイルを選択します。
メニューバーで、[ビュー]、[開く] を選択します。
プロパティの一覧で、[INSTALLDIR] のプロパティの横に [参照] のボタンをクリックします。
[Set INSTALLDIR] のダイアログボックスで、ソリューションをインストールするユーザーのコンピューターのフォルダーを選択します。

[!メモ]

で、一覧のフォルダーのショートカットメニューを開いて [Set INSTALLDIR] のダイアログボックスのサブディレクトリを作成できます。

アプリケーションレベルのアドインを構成します。

ここでは、アプリケーションレベルのアドインを you'redeploying のみ適用されます。ドキュメントレベルのカスタマイズを配置すると、ドキュメントレベルのカスタマイズを構成します。のセクションにすばやく移動できます。

アドインを検出して読み込む Office アプリケーションを有効にするようにレジストリキーを作成する必要があります。レジストリキーの位置は、Office アプリケーションによって異なります。詳細については、「アプリケーションレベルのアドインのレジストリエントリ」を参照してください。

レジストリを構成するには

[ソリューションエクスプローラー] では、[OfficeAddInSetup] のプロジェクトノードを展開し、[Organize Your Setup] のノードを展開し、を [一般情報] のファイルを選択します。
メニューバーで、[ビュー]、[開く] を選択します。

セットアッププロジェクトのプロパティが表示されます。
[AllUSERS] のプロパティの一覧で、このソリューションにコンピューターのすべてのユーザーまたはソリューションをインストールするユーザーのみにインストールするかどうかを指定します。

すべてのユーザーのソリューションをインストールするには、[ALLUSERS=1 (Per-machine installation)] を選択します。
[ソリューションエクスプローラー] では、[Project Assistant] のノードを選択します。

メニューバーで、[ビュー]、[開く] を選択します。
[Project assistant] ページの下部に、次の図に示す [Application Registry] のボタンを選択します。

[Application Registry] のページが表示されます。
[Do you want to configure the registry data that your application will install?] の下に、○ のオプションボタンを選択します。
[Destination computer’s Registry view] の一覧で、HKEY_USER_SELECTABLEを選択します。

HKEY_USER_SELECTABLE フォルダーはに基づいて適切なレジストリハイブこの手順の [ALLUSERS] のプロパティに前に選択した内容にインストールされます。[ALLUSERS=1 (Per-machine installation)] にプロパティがレジストリの HKEY_LOCAL_MACHINE ハイブに、ソリューションインストールセット。
HKEY_USER_SELECTABLE フォルダーのショートカットメニューを開き、[新規作成] を選択し、を [キー] を選択します。

[New Key #1] という名前のフォルダーが HKEY_USER_SELECTABLE フォルダーの下に表示されます。
新しいフォルダー [ソフトウェア] の名前を変更します。
[ソフトウェア] フォルダーのショートカットメニューを開き、[新規作成] を選択し、を [キー] を選択します。

[New Key #1] という名前のフォルダーが [ソフトウェア] フォルダーの下に表示されます。
全体の主要な階層を表すまで [Microsoft] 新しいフォルダーの名前を変更し、サブフォルダーを作成します。

階層全体のキーは HKEY_USER_SELECTABLE\Software\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddInです。

Office 64 ビットバージョンのインストーラーを作成する場合は、階層全体は HKEY_USER_SELECTABLE\Software\Wow6432Node\Microsoft\Office\Excel\Addins\SampleCompany.ExcelAddInです。

次の図は、この手法を完了したらキーの階層構造を示しています。

[!メモ]

ベストプラクティスとして、会社名で、アドインの名前を起動します。この規則はキーは一意である向上し、別のサプライヤーからアドインの競合の可能性を削減する可能性があります。アドインは、同じ名前を持つたとえば、互いの登録のキーを上書きできます。この方法は、一意キーが確実であることができません。また、潜在的な名前の競合を減らすことができます。
[SampleCompany.ExcelAddIn] キーのショートカットメニューを開き、[新規作成] を選択し、を [文字列の値] を選択します。

新しい文字列値が [the Destination computer’s Registry data] の一覧に表示されます。文字列値の名前は、その名前を変更できるように強調表示されます。
説明に値の名前を変更します。
次の値を作成するには、このプロセスを繰り返します。

値型

名前

文字列値

FriendlyName

DWORD 値

[LoadBehavior]

文字列値

マニフェスト
[説明] の値のショートカットメニューを開き、[変更] を選択します。

[データの編集] のダイアログボックスが表示されます。
[値のデータ] のテキストボックスに、Excel のアドインのデモを入力し、を [OK] のボタンをクリックします。

この説明は、次にユーザーが Office アプリケーションを開いたり、[オプション] のダイアログボックスと、[アドイン] のウィンドウで開くと、アドインを選択して表示されます。
[FriendlyName] の値のショートカットメニューを開き、[変更] を選択します。

[データの編集] のダイアログボックスが表示されます。
[値のデータ] のテキストボックスに、Excel のアドインのデモを入力し、を [OK] のボタンをクリックします。

この文字列は、Office アプリケーションの [COM アドイン] のダイアログボックスに表示されます。既定では、文字列の値はアドイン ID です。
[LoadBehavior] の値のショートカットメニューを開き、[変更] を選択します。

[データの編集] のダイアログボックスが表示されます。
[値のデータ] のテキストボックスに、3 を入力し、[OK] のボタンをクリックします。

アプリケーションの起動時に 3 回アドインの読み込みの値。LoadBehavior の値の詳細については、アプリケーションレベルのアドインのレジストリエントリを参照してください。
[マニフェスト] の値のショートカットメニューを開き、[変更] を選択します。

[データの編集] のダイアログボックスが表示されます。
[値のデータ] のテキストボックスに、file:///[INSTALLDIR]ExcelAddIn.vsto|vstolocal を入力し、[OK] のボタンをクリックします。

Office ランタイムの Visual Studio 2010 Tools は、配置マニフェストを見つけるために、このパスを使用します。このパスの [INSTALLDIR] の部分は INSTALLDIR には、InstallShield のセットアッププロジェクトの [一般情報] のプロパティページのプロパティにマップするマクロです。このプロパティは、ターゲットコンピューターにアドインをインストールする位置を指定します。|vstolocal のサフィックスは、ソリューションをインストールフォルダーから読み込むことを、ClickOnce キャッシュ確認します。

次の図は、この手法を完了すると、の値がどのように表示されるかを示します。

値型	名前
文字列値	FriendlyName
DWORD 値	[LoadBehavior]
文字列値	マニフェスト

重要
Outlook のアドインのカスタムフォーム領域を作成する場合は、Outlook の領域を登録するためのレジストリエントリを作成する必要があります。詳細については、「Outlook フォーム領域のレジストリエントリ」を参照してください。

ドキュメントレベルのカスタマイズを構成します。

このセクションでは、ドキュメントレベルのカスタマイズを配置する場合にのみ適用されます。アプリケーションレベルのアドインを配置する場合、セットアッププロジェクトをビルドのセクションにすばやく移動できます。

ドキュメントレベルのカスタマイズは、レジストリキーを使用しません。代わりに、カスタムドキュメントプロパティは配置マニフェストの位置が含まれています。

カスタムプロパティを変更するには、ドキュメントのドキュメントレベルのカスタマイズを削除するプログラムを変更し、適切なプロパティを、次に文書に再アタッチされますカスタマイズを作成します。その後、プログラムを実行し、セットアッププロジェクトに追加アクションカスタム動作を作成します。

ドキュメントプロパティを変更するプログラムを作成します。

メニューバーで [ファイル] をクリックし、[追加] を選択し、[新しいプロジェクト] をクリックします。

[新しいプロジェクトの追加] ダイアログボックスが表示されます。
使用する言語のノードの下のテンプレートペインで、[ウィンドウ] フォルダーを選択します。
[ウィンドウ] のプロジェクトの種類の一覧で、[コンソールアプリケーション] テンプレートを選択します。
プロジェクト SetExcelDocumentProperties の名前を指定し、を [OK] のボタンをクリックします。
[ソリューションエクスプローラー] では、[すべてのファイルを表示] のボタンを選択し、[SetExcelDocumentProperties] のプロジェクトノードのショートカットメニューを開き、を [参照の追加] を選択します。
[参照マネージャー] のダイアログボックスで、[拡張機能] のタブをクリックし、次のアセンブリの横にあるチェックボックスをオンに [OK] のボタンをクリックします。
- Microsoft.VisualStudio.Tools.Applications.Runtime
- [Microsoft.VisualStudio.Tools.Applications.ServerDocument]
[ソリューションエクスプローラー] では、[Program.cs] ファイル (、C のアプリケーションの場合) または [Module1.vb] ファイルを選択します (Visual Basic アプリケーションの場合)。
メニューバーで、[ビュー]、[開く] を選択します。

次のコードに、ファイル全体の内容を置き換えます。

Imports Microsoft.VisualStudio.Tools.Applications.Runtime
Imports Microsoft.VisualStudio.Tools.Applications

Module Module1

    Sub Main()

        Dim assemblyLocation As String = ""
        Dim solutionID As Guid
        Dim deploymentManifestLocation As Uri = Nothing
        Dim documentLocation As String = ""
        Dim nonpublicCachedDataMembers As String() = Nothing

        Dim CommandLineArgs As  _
            System.Collections.ObjectModel.ReadOnlyCollection(Of String) = _
            My.Application.CommandLineArgs

        For i As Integer = 0 To CommandLineArgs.Count - 1

            Console.WriteLine(CommandLineArgs(i))
            Dim oArugment As String() = CommandLineArgs(i).Split("=")

            Select Case oArugment(0)

                Case "/assemblyLocation"
                    assemblyLocation = oArugment(1)

                Case "/deploymentManifestLocation"
                    If Not Uri.TryCreate(oArugment(1), UriKind.Absolute, _
                                         deploymentManifestLocation) Then
                        MsgBox("Error creating URI")
                    End If

                Case "/documentLocation"
                    documentLocation = oArugment(1)

                Case "/solutionID"
                    solutionID = Guid.Parse(oArugment(1))
            End Select
        Next
        Try
            ServerDocument.RemoveCustomization(documentLocation)
            ServerDocument.AddCustomization(documentLocation, assemblyLocation, _
                                            solutionID, deploymentManifestLocation, _
                                            True, nonpublicCachedDataMembers)

            Console.WriteLine("Insallation Location Modified Successfully")

        Catch ex As System.IO.FileNotFoundException
            Console.WriteLine("The specified document does not exist.")
            Console.ReadLine()


        Catch ex As System.IO.IOException
            Console.WriteLine("The specified document is read-only.")
            Console.ReadLine()


        Catch ex As InvalidOperationException

            Console.WriteLine("The customization could not be removed.\n" &
                ex.Message)
            Console.ReadLine()


        Catch ex As DocumentNotCustomizedException
            Console.WriteLine("The document could not be customized.\n" &
                ex.Message)
            Console.ReadLine()

        End Try
    End Sub

End Module

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.VisualStudio.Tools.Applications.Runtime;
using Microsoft.VisualStudio.Tools.Applications;

namespace SetExcelDocumentProperties
{
    class Program
    {
        static void Main(string[] args)
        {
            string assemblyLocation = "";
            Guid solutionID = new Guid();
            Uri deploymentManifestLocation = null;
            string documentLocation = "";
            string[] nonpublicCachedDataMembers = null;

            for (int i = 0; i <= args.Count() - 1; i++)
            {
                Console.WriteLine(args[i]);
                string[] oArugment = args[i].Split('=');

                switch (oArugment[0])
                {
                    case "/assemblyLocation":
                        assemblyLocation = oArugment[1];
                        break;
                    case "/deploymentManifestLocation":
                        if (!Uri.TryCreate(oArugment[1], UriKind.Absolute, out deploymentManifestLocation))
                        {
                            Console.WriteLine("Error creating URI");
                        }
                        break;
                    case "/documentLocation":
                        documentLocation = oArugment[1];
                        break;
                    case "/solutionID":
                        solutionID = Guid.Parse(oArugment[1]);
                        break;
                }
            }
            try
            {
                ServerDocument.RemoveCustomization(documentLocation);
                ServerDocument.AddCustomization(documentLocation, assemblyLocation,
                                            solutionID, deploymentManifestLocation,
                                            true, out nonpublicCachedDataMembers);

            }
            catch (System.IO.FileNotFoundException)
            {
                Console.WriteLine("The specified document does not exist.");
            }
            catch (System.IO.IOException)
            {
                Console.WriteLine("The specified document is read-only.");
            }
            catch (InvalidOperationException ex)
            {
                Console.WriteLine("The customization could not be removed.\n" +
                    ex.Message);
            }
            catch (DocumentNotCustomizedException ex)
            {
                Console.WriteLine("The document could not be customized.\n" +
                    ex.Message);
            }
        }
    }
}

プロジェクトをコンパイルします。

プログラムを実行するカスタム動作を追加するには

[ソリューションエクスプローラー] では、[OfficeAddInSetup] のプロジェクトノードを展開し、次の図に示す [Project Assistant] ファイルを選択します。
メニューバーで、[ビュー]、[開く] を選択します。
[Project assistant] ページの下部に、次の図に示す [アプリケーションファイル] のボタンを選択します。
[アプリケーションファイル] のページで、[プロジェクト出力の追加] のボタンをクリックします。

[Visual Studio Output Selector] ]ダイアログボックスが表示されます。
[SetExcelDocumentProperties] のノードの下で、[プライマリ出力] のチェックボックスをオンにし、[OK] のボタンをクリックします。
[ソリューションエクスプローラー] では、[OfficeAddInSetup] のノードの下で、[Define Setup Requirements and Actions] のノードを展開し、[カスタム動作] フォルダーを選択します。
メニューバーで、[ビュー]、[開く] を選択します。

イベントの一覧は、画面の端にウィンドウに表示されます。

[!メモ]

この一覧に表示されるいくつかのイベントのみ InstallShield Limited Edition で使用できます。この手順では、[After Setup Complete Success dialog] のイベントを使用して、プログラムを実行します。

イベントの一覧で、[Custom Actions During Installation] の下に、[After Setup Complete Success dialog] のイベントのショートカットメニューを開き、[New EXE] を選択します。

[NewCustomAction1] という名前のカスタム動作は [After Setup Complete Success dialog] のイベントの下に表示されます。一連のカスタム動作のプロパティは、イベントの横にウィンドウに表示されます。

重要
[After Setup Complete Success dialog] の 2 種類のイベントはイベントの一覧に表示されます。[Custom Actions During Installation] ノードの下にある [After Setup Complete Success dialog] のイベントインスタンスを選択してください。

[ソースの場所] のプロパティの一覧で、[Installed with the Product] を選択します。
[ファイル名] のプロパティの横に [参照] のボタンをクリックします。
[Browse for a Destination File] のダイアログボックスで、[SetExcelDocumentProperties.Primary.output] のファイルを選択し、を [開く] のボタンをクリックします。

このファイルの場所は、セットアッププロジェクトの [INSTALLDIR] のプロパティに指定したフォルダーに依存します。たとえば、**[[PersonalFolder]DemoWorkbookApp]**という名前のフォルダーに、プロパティ [ProgramFilesFolder] \DemoWorkbookAppを参照して [SetExcelDocumentProperties.Primary.output] ファイルを検索できる設定します。

これからの手順では、ドキュメントのソリューションの ID を取得し、パラメーターとしてコンソールアプリケーションにその ID を渡します。また、ドキュメント、配置マニフェスト、およびドキュメントのアセンブリの位置を渡します。
[ExcelWorkbook] のプロジェクトのアプリケーションのショートカットメニューを開いて、オペレーティングシステムによって [Windows エクスプローラーでフォルダーを開く] か [エクスプローラーでフォルダーを開く] を選択します。

ソリューションを含むフォルダーが開きます。
メモ帳のソリューションのプロジェクトファイルを開きます。Visual Basic プロジェクトの場合、ファイル名は ExcelWorkbook.vbproj です。、C のプロジェクトの場合、ファイル名は ExcelWorkbook.csproj です。
プロジェクトファイルで、<SolutionID> の要素の検索は、値をクリップボードにコピーし、メモ帳を閉じます。

コンソールアプリケーションにパラメーターとしてこの値を渡します。

[NewCustomAction1] のプロパティページで、次のテキスト行に [コマンドライン] のプロパティを設定します。

/assemblyLocation="[INSTALLDIR]ExcelWorkbook.dll" /deploymentManifestLocation="[INSTALLDIR]ExcelWorkbook.vsto" /documentLocation="[INSTALLDIR]ExcelWorkbook.xlsx" /solutionID="Your Solution ID"

クリップボードにコピーし、ソリューションの ID と Your Solution ID を置き換えます。

重要
このカスタム動作を実行するコンソールアプリケーションが INSTALLDIR [出力]ディレクトリのドキュメントにアクセスできることを確認するためのインストーラーをテストします。ユーザーのコンピューターのあるディレクトリに管理アクセス (たとえば、Program Files ディレクトリ) を必要とする場合があります。管理アクセスを必要とするディレクトリにソリューションを配置すると、インストーラーを配布する前に、setup.exe ファイルに [プロパティ] のダイアログボックスを開く必要が [互換性] のタブをクリックし、を [Run this program as administrator] のチェックボックスをオンにします。ユーザーが管理者権限のセットアッププログラムを実行しない場合はユーザーは、アクセスが既に存在 [ドキュメント] ディレクトリなどのディレクトリに [INSTALLDIR] プロパティを設定します。詳細については、このトピックの「ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。」セクションを参照してください。

このカスタム動作を実行するコンソールアプリケーションが INSTALLDIR [出力]ディレクトリのドキュメントにアクセスできることを確認するためのインストーラーをテストします。ユーザーのコンピューターのあるディレクトリに管理アクセス (たとえば、Program Files ディレクトリ) を必要とする場合があります。管理アクセスを必要とするディレクトリにソリューションを配置すると、インストーラーを配布する前に、setup.exe ファイルに [プロパティ] のダイアログボックスを開く必要が [互換性] のタブをクリックし、を [Run this program as administrator] のチェックボックスをオンにします。ユーザーが管理者権限のセットアッププログラムを実行しない場合はユーザーは、アクセスが既に存在 [ドキュメント] ディレクトリなどのディレクトリに [INSTALLDIR] プロパティを設定します。詳細については、このトピックの「ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。」セクションを参照してください。

セットアッププロジェクトをビルド

[ソリューションエクスプローラー] では、[Prepare for Release] のノードを展開し、[解放] のファイルを選択します。
メニューバーで、[ビュー]、[開く] を選択します。

[ビルド] のエクスプローラーには、作業ウィンドウの作成するリリースの種類を選択できるようになります。
[ビルド] のエクスプローラーで、[SingleImage] フォルダーを選択します。
[ビルド] のエクスプローラーの横のペインで、[Setup.exe] のタブをクリックします。
[Setup.exe] のプロパティページで、[InstallShield Prerequisites Location] の一覧から、[Extract From Setup.exe] を選択します。
メニューバーで、[ビルド]、[構成マネージャー] を選択します。
[アクティブソリューション構成] の一覧で、[SingleImage] を選択します。
[OfficeAddInSetup] のプロジェクトの [構成] の列の [Project contexts] の表では、[SingleImage] を選択し、[閉じる] のボタンをクリックします。
メニューバーで、[ビルド]、[Build OfficeAddInSetup] を選択します。

ビルドが完了したら、次の位置に [OfficeAddInSetup] のプロジェクトで setup.exe ファイルを配置できます: OfficeAddInSetupProjectRoot\OfficeAddInSetup\Express\SingleImage\DiskImages\DISK1\

参照

概念

カスタムドキュメントプロパティの概要

Office ソリューションへの信頼の付与

ドキュメントへの信頼の付与

その他の技術情報

Office ソリューションを配置するための必須コンポーネント

Office ソリューションの配置

Windows インストーラーを使用して Office ソリューションの Visual Studio 2010 Tools の配置

次の方法で共有

Windows インストーラーを使用した Office ソリューションの配置

このトピックの内容

サンプルをダウンロードします。

ソリューションに信頼を付与する方法を決定します。

InstallShield に制限バージョンを取得します。

InstallShield に制限バージョンを取得するには

セットアッププロジェクトを作成します。

プロジェクト出力を追加します

プロジェクト出力を追加するには

配置マニフェストおよびアプリケーションマニフェストを追加します。

必須コンポーネントとして依存コンポーネントを構成します。

必要条件として .NET Framework 4 または .NET Framework 4.5 を追加します

Office ランタイムの Visual Studio 2010 Tools を追加します。

Office ランタイムの Visual Studio 2010 Tools を必須コンポーネントとして追加するには

ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。

アプリケーションレベルのアドインを構成します。

レジストリを構成するには

ドキュメントレベルのカスタマイズを構成します。

ドキュメントプロパティを変更するプログラムを作成します。

プログラムを実行するカスタム動作を追加するには

セットアッププロジェクトをビルド

参照

関連項目

概念

その他の技術情報

その他のリソース

次の方法で共有

Windows インストーラーを使用した Office ソリューションの配置

このトピックの内容

サンプルをダウンロードします。

ソリューションに信頼を付与する方法を決定します。

InstallShield に制限バージョンを取得します。

InstallShield に制限バージョンを取得するには

セットアップ プロジェクトを作成します。

プロジェクト出力を追加します

プロジェクト出力を追加するには

配置マニフェストおよびアプリケーション マニフェストを追加します。

必須コンポーネントとして依存コンポーネントを構成します。

必要条件として .NET Framework 4 または .NET Framework 4.5 を追加します

Office ランタイムの Visual Studio 2010 Tools を追加します。

Office ランタイムの Visual Studio 2010 Tools を必須コンポーネントとして追加するには

ユーザーのコンピューターにソリューションをインストール方法とインストール場所を指定します。

アプリケーション レベルのアドインを構成します。

レジストリを構成するには

ドキュメント レベルのカスタマイズを構成します。

ドキュメント プロパティを変更するプログラムを作成します。

プログラムを実行するカスタム動作を追加するには

セットアップ プロジェクトをビルド

参照

関連項目

概念

その他の技術情報

その他のリソース

セットアッププロジェクトを作成します。

配置マニフェストおよびアプリケーションマニフェストを追加します。

アプリケーションレベルのアドインを構成します。

ドキュメントレベルのカスタマイズを構成します。

ドキュメントプロパティを変更するプログラムを作成します。

セットアッププロジェクトをビルド