チュートリアル : 異なるローカルフォルダへのドキュメントとアセンブリの配置 (2003 システム)

[アーティクル]
04/28/2010

更新 : 2007 年 11 月

対象
このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。プロジェクトの種類ドキュメントレベルのプロジェクト Microsoft Office のバージョン Microsoft Office 2003 詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このトピックの情報は、指定された Visual Studio Tools for Office プロジェクトおよび Microsoft Office のバージョンにのみ適用されます。

プロジェクトの種類

ドキュメントレベルのプロジェクト

Microsoft Office のバージョン

Microsoft Office 2003

詳細については、「アプリケーションおよびプロジェクトの種類別の使用可能な機能」を参照してください。

このチュートリアルでは、ドキュメントレベルのカスタマイズを配置して、エンドユーザーのコンピュータの異なるフォルダにドキュメントとアセンブリを格納する方法について説明します。この種類の配置は、ローカル/ローカル配置モデルと呼ばれます。

ソリューションの配置に関するオプションの詳細については、「配置モデル (2003 システム)」を参照してください。ドキュメントレベルのカスタマイズの詳細については、「ドキュメントレベルのカスタマイズのアーキテクチャ」を参照してください。

このチュートリアルでは、次のタスクについて説明します。

アセンブリを指すように、ドキュメントに埋め込まれたアプリケーションマニフェストを編集。
ローカルフォルダに格納された Visual Studio Tools for Office ソリューションアセンブリに完全な信頼を付与。

前提条件

このチュートリアルを完了するには、次のコンポーネントが必要です。

Visual Studio Tools for Office (Visual Studio 2008 Professional および Visual Studio Team System のオプションの要素)

Microsoft Office Word 2003 または Microsoft Office Excel 2003

メモ :
このチュートリアルでは、Word ソリューションを配置することを前提としています。Excel ソリューションを使用してチュートリアルを実行する場合は、すべてのコード例で、Word プロジェクトの名前を Excel プロジェクトの名前に置き換えてください。

開発用コンピュータにおける管理者特権 (セキュリティポリシーを設定できるようにするため)。

配置するソリューションの作成

最初に、配置する基本の Visual Studio Tools for Office ソリューションを作成します。配置するソリューションを既に作成してある場合は、このセクションをスキップして、「ソリューションの配置」に進んでください。

配置するソリューションを作成するには

Office 2003 のプロジェクトテンプレートを使用して、WordDeployment という名前の Word 文書プロジェクトを作成します。

ウィザードで、[新規ドキュメントの作成] をクリックします。詳細については、「方法 : Visual Studio Tools for Office プロジェクトを作成する」を参照してください。
ソリューションエクスプローラで、ThisDocument コードファイルを右クリックし、[コードの表示] をクリックします。
ThisDocument_Startup イベントハンドラに次のコードを追加します。このコードを追加すると、ドキュメントが開いたときにメッセージが表示され、ソリューションが正しく配置されたかどうかを簡単に確認できます。
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Startup イベントの詳細については、「Visual Studio Tools for Office プロジェクトのイベント」を参照してください。
F5 キーを押して、プロジェクトをビルドおよび実行します。メッセージが表示されることを確認します。

ソリューションの配置

次の手順では、開発用コンピュータ上の異なるフォルダにドキュメントとアセンブリを配置します。

ソリューションを配置するには

TestDeployDocument および TestDeployAssembly という名前のフォルダを Windows システムドライブ (%SystemDrive%) のルートに作成します。たとえば、システムドライブが C の場合、新しいフォルダは C:\TestDeployDocument および C:\TestDeployAssembly になります。
ビルド出力フォルダ (通常は project folder\bin\debug または project folder\bin\release) から %SystemDrive%\TestDeployDocument フォルダにドキュメントをコピーし、ビルド出力フォルダから %SystemDrive%\TestDeployAssembly フォルダにアセンブリをコピーします。
%SystemDrive%\TestDeployDocument フォルダのドキュメントを開きます。カスタマイズアセンブリが見つからないか、読み込めないというエラーメッセージが表示されます。

ソリューションのビルド時には、ドキュメントによって、アセンブリがドキュメントと同じフォルダにあるものと想定されます。アセンブリの場所は、ドキュメントに埋め込まれているアプリケーションマニフェストに保存されます。ドキュメントとアセンブリを異なるフォルダに配置する場合、埋め込まれているアプリケーションマニフェストを編集して新しいアセンブリパスを指定する必要があります。次のセクションでは、この手順について説明します。
Word を終了します。
Visual Studio でソリューションを閉じます。

ドキュメントが、Word のインスタンスやプロジェクトデザイナで開かれていないことを確認します。ドキュメントが開かれていると、次の手順で行われる ServerDocument によるドキュメントへのアクセスの試みが失敗します。

埋め込まれたアプリケーションマニフェストの編集

ServerDocument クラスを使用してドキュメントに埋め込まれたアプリケーションマニフェストを編集し、カスタマイズアセンブリの新しい場所を指すようにします。ServerDocument を使用して埋め込まれたアプリケーションマニフェストを編集するためのコードは、配置するドキュメントに関連付けられている Visual Studio Tools for Office プロジェクトアセンブリの外に指定する必要があります。

埋め込まれたアプリケーションマニフェストを編集するには

新しいコンソールアプリケーションプロジェクトを作成します。詳細については、「方法 : ソリューションおよびプロジェクトを作成する」を参照してください。
新しいプロジェクトに Microsoft.VisualStudio.Tools.Applications.Runtime.dll アセンブリに対する参照を追加します。
次の using ステートメント (C#) または Imports ステートメント (Visual Basic) を、Program.cs コードファイルか Module1.vb コードファイルの最初に追加します。
```
Imports Microsoft.VisualStudio.Tools.Applications.Runtime
```
```
using Microsoft.VisualStudio.Tools.Applications.Runtime;
```
次のコードを Main メソッドに追加して、埋め込まれたアプリケーションマニフェストを更新します。full document path は、開発用コンピュータの配置場所におけるドキュメントの完全パス (たとえば C:\TestDeployDocument\WordDeployment.doc) に置き換えます。full assembly path は、配置先のフォルダにおけるアセンブリの完全パス (たとえば C:\TestDeployAssembly\WordDeployment.dll) に置き換えます。
```
Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("full document path")
    sd.AppManifest.Dependency.AssemblyPath = _
        "full assembly path"
    sd.Save()
Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try
```
```
ServerDocument sd = null;
try
{
    sd = new ServerDocument(@"full document path");
    sd.AppManifest.Dependency.AssemblyPath = 
        @"full assembly path";
    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}
```
F5 キーを押して、プロジェクトをビルドおよび実行します。コンソールアプリケーションによって、埋め込まれたアプリケーションマニフェストのアセンブリパスが更新され、コンソールアプリケーションが閉じます。
コンソールアプリケーションプロジェクトを閉じます。
%SystemDrive%\TestDeployDocument フォルダのドキュメントを開きます。現在の .NET セキュリティポリシーではカスタマイズの実行は許可されないというエラーメッセージが表示されます。これは、アセンブリに完全な信頼をまだ付与していないからです。
Word を終了します。

Word のすべてのインスタンスを閉じる必要があります。そうでないと、セキュリティポリシーの変更が反映されません。

セキュリティポリシーの設定

ソリューションを実行するには、.NET Framework 2.0 セキュリティポリシーでアセンブリに完全な信頼を付与する必要があります。このチュートリアルでは、アセンブリに完全な信頼を付与するために、コードアクセスセキュリティポリシーツール (Caspol.exe) を使用します。Caspol.exe の使用方法の詳細については、「コードアクセスセキュリティポリシーツール (Caspol.exe)」および「コードアクセスセキュリティポリシーツール (Caspol.exe) によるセキュリティポリシーの構成」を参照してください。

セキュリティに関するメモ :
このチュートリアルでは、URL の証拠に基づいてセキュリティポリシーを設定する基本的な手順を実行します。実際のソリューションでアセンブリの場所の安全性が不明な場合は、これらの手順を実行しないでください。実行すると、アセンブリに信頼が付与されてしまいます。また、実際のソリューションでは、アセンブリの URL 以上の証拠に基づいて安全性を確認してください。詳細については、「Office ソリューションの実行に必要なセキュリティ条件 (2003 システム)」を参照してください。

このチュートリアルでは、URL の証拠に基づいてセキュリティポリシーを設定する基本的な手順を実行します。実際のソリューションでアセンブリの場所の安全性が不明な場合は、これらの手順を実行しないでください。実行すると、アセンブリに信頼が付与されてしまいます。また、実際のソリューションでは、アセンブリの URL 以上の証拠に基づいて安全性を確認してください。詳細については、「Office ソリューションの実行に必要なセキュリティ条件 (2003 システム)」を参照してください。

アセンブリに完全な信頼を付与するには

コマンドプロンプトで次のコマンドを入力して、アセンブリに完全な信頼を付与する新しいコードグループを作成します。
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
full assembly path は、開発用コンピュータ上のアセンブリの完全パス (たとえば C:\TestDeployAssembly\WordDeployment.dll) に置き換えます。

-n パラメータは、新規コードグループの名前を示します。このパラメータは省略可能ですが、ラベルを指定しておくと、このチュートリアルを完了した後で新規コードグループを簡単に識別および削除できるようになります。
操作を実行するかどうかを確認するメッセージが表示されたら、「yes」と入力し、Enter キーを押します。
%SystemDrive%\TestDeployDocument フォルダのドキュメントを開いて、メッセージが表示されることを確認します。