チュートリアル : ネットワークフォルダへのドキュメントとアセンブリの配置 (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 キーを押して、プロジェクトをビルドおよび実行します。メッセージが表示されることを確認します。
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 は、開発用コンピュータのビルド場所におけるドキュメントの完全パス (たとえば project folder\bin\debug\WordDeployment.doc) に置き換えます。full assembly path は、配置先のネットワークフォルダにおけるアセンブリの完全パス (たとえば \\DeploymentServer\DeploymentFolder\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();
    }
}
```
プロジェクトをビルドして実行します。コンソールアプリケーションによって、埋め込まれているアプリケーションマニフェストのアセンブリパスが更新され、その後、コンソールアプリケーションが閉じます。
コンソールアプリケーションプロジェクトを閉じます。

ソリューションの配置

パスが正しければ、ドキュメントとアセンブリをネットワークコンピュータの同じフォルダに配置できます。

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

ネットワークコンピュータ上に "DeploymentFolder" という名前のフォルダを作成し、そのフォルダを自分専用にします。たとえば、ネットワークコンピュータの名前が "DeploymentServer" の場合、新しいネットワーク共有は \\DeploymentServer\DeploymentFolder になります。ネットワーク共有が、前の手順で埋め込まれているアプリケーションマニフェストを編集したときに full assembly path プレースホルダに指定した名前と同じ名前であることを確認してください。
ビルド出力フォルダ (通常は project folder\bin\debug または project folder\bin\release) から \\DeploymentServer\DeploymentFolder ネットワーク共有にドキュメントとアセンブリをコピーします。
\\DeploymentServer\DeploymentFolder ネットワーク共有のドキュメントを開きます。カスタマイズアセンブリが見つからないか、または読み込めないことを示すエラーメッセージが表示されます。これは、ネットワークフォルダのドキュメントとアセンブリに完全な信頼が付与されていないからです。
[OK] をクリックし、ドキュメントを閉じます。

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

ソリューションを実行するには、.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 -m -ag LocalIntranet_Zone -url "full assembly path" FullTrust -n "Test_Deployment_Assembly"
```
full assembly path は、ネットワークフォルダ内のアセンブリの完全パス (たとえば \\DeploymentServer\DeploymentFolder\WordDeployment.dll) に置き換えます。

-n パラメータは、新しいコードグループの名前を指定します。このパラメータの指定は必須ではありませんが、ラベルを指定すると、このチュートリアルの終了後に新しいコードグループを特定し、削除するのが簡単になります。
操作の実行を確認するプロンプトが表示されたら、「yes」と入力し、Enter キーを押します。
次のコマンドを入力して、ドキュメントに完全な信頼を付与する新しいコードグループを作成し、Enter キーを押します。自分がエンドユーザーとしてネットワークフォルダからドキュメントを開くことになるので、ドキュメントに完全な信頼を付与する必要があります。ドキュメントがエンドユーザーのコンピュータ上にある場合、完全な信頼は必要ありません。
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -m -ag LocalIntranet_Zone -url "full document path" FullTrust -n "Test_Deployment_Document"
```
full document path は、ネットワークフォルダ内のドキュメントの完全パス (たとえば \\DeploymentServer\DeploymentFolder\WordDeployment.doc) に置き換えます。

-n パラメータは、新しいコードグループの名前を指定します。このパラメータの指定は必須ではありませんが、ラベルを指定すると、このチュートリアルの終了後に新しいコードグループを特定し、削除するのが簡単になります。
操作の実行を確認するプロンプトが表示されたら、「yes」と入力し、Enter キーを押します。
開発用コンピュータで \\DeploymentServer\DeploymentFolder ネットワークフォルダのドキュメントを開き、メッセージが表示されることを確認します。
ドキュメントを開発用コンピュータのフォルダに保存し、ドキュメントを閉じます。
開発用コンピュータでドキュメントを開き、メッセージが表示されることを確認します。

これは、埋め込まれているアプリケーションマニフェストに、ネットワークコンピュータ上のアセンブリの完全パスが含まれているために機能します。埋め込まれているアプリケーションマニフェストでアセンブリのパスを編集しないと、ネットワークフォルダからドキュメントを開いた場合にのみソリューションが実行されます。