チュートリアル : ローカルフォルダへのドキュメントとアセンブリの配置 (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 キーを押して、プロジェクトをビルドおよび実行します。メッセージが表示されることを確認します。

ソリューションの配置

これで、開発用コンピュータ上の新規フォルダにドキュメントとアセンブリを配置できます。

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

"TestDeploy" という名前のフォルダを Windows システムドライブ (%SystemDrive%) のルートに作成します。たとえば、システムドライブが C の場合、ディレクトリは C:\TestDeploy になります。
ビルド出力フォルダ (通常は project folder\bin\debug または project folder\bin\release) から %SystemDrive%\TestDeploy フォルダにドキュメントとアセンブリをコピーします。
%SystemDrive%\TestDeploy フォルダのドキュメントを開きます。現在の .NET セキュリティポリシーではカスタマイズの実行は許可されないというエラーメッセージが表示されます。これは、アセンブリに完全な信頼をまだ付与していないからです。
[OK] をクリックし、ドキュメントを閉じます。

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

ソリューションを実行する前に、.NET Framework 2.0 セキュリティポリシーでアセンブリに完全な信頼を付与する必要があります。このチュートリアルでは、アセンブリに完全な信頼を付与するために、コードアクセスセキュリティポリシーツール (Caspol.exe) を使用します。

Caspol.exe の使用方法の詳細については、「コードアクセスセキュリティポリシーツール (Caspol.exe)」および「コードアクセスセキュリティポリシーツール (Caspol.exe) によるセキュリティポリシーの構成」を参照してください。

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

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

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

コマンドプロンプトで次のコマンドを入力して、アセンブリに完全な信頼を付与する新しいコードグループを作成します。full assembly path は、開発用コンピュータ上のアセンブリの完全パス (たとえば C:\TestDeploy\WordDeployment.dll) に置き換えます。
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
-n パラメータは、新規コードグループの名前を示します。このパラメータは省略可能ですが、ラベルを指定しておくと、このチュートリアルを完了した後で新規コードグループを簡単に識別および削除できるようになります。
操作を実行するかどうかを確認するメッセージが表示されたら、「yes」と入力し、Enter キーを押します。
%SystemDrive%\TestDeploy フォルダのドキュメントを開いて、メッセージが表示されることを確認します。
[OK] をクリックし、ドキュメントを閉じます。