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

更新 : 2007 年 11 月

対象

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

プロジェクトの種類

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

Microsoft Office のバージョン

  • 2007 Microsoft Office system

  • Microsoft Office 2003

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

ドキュメントがドキュメント レベルのカスタマイズの一部である場合、そのドキュメントには、Visual Studio Tools for Office によって _AssemblyLocation および _AssemblyName という 2 つのカスタム プロパティが用意されます。ユーザーがドキュメントを開くと、Microsoft Office アプリケーションがこの 2 つのカスタム ドキュメント プロパティをチェックします。ドキュメントにこれらのプロパティが存在する場合は、アプリケーションが Visual Studio Tools for Office ランタイムを読み込み、そのランタイムによってカスタマイズが起動されます。詳細については、「Visual Studio Tools for Office ソリューションのアーキテクチャ」を参照してください。

これらのプロパティの値は、ソリューションの対象となる Microsoft Office が次のどちらのバージョンであるかによって異なります。

  • Microsoft Office の 2007 リリース

  • Microsoft Office の 2003 リリース

2007 Microsoft Office ソリューションのカスタム プロパティ

  • _AssemblyName

    このプロパティには、Visual Studio Tools for Office ローダー内のインターフェイスの CLSID が含まれます。CLSID 値は 4E3C66D5-58D4-491E-A7D4-64AF99AF6E8B です。この値は変更しないでください。

  • _AssemblyLocation

    このプロパティには、カスタマイズの配置マニフェストに関する詳細を示す文字列が含まれます。マニフェストの詳細については、「Office ソリューションにおけるアプリケーション マニフェストと配置マニフェスト」を参照してください。

_AssemblyLocation プロパティの形式

_AssemblyLocation プロパティの値は、ソリューションの配置方法によって形式が異なります。

  • ソリューションを、Web サイト、UNC パス、CD ドライブ、または USB ドライブからのインストールを前提として発行した場合、_AssemblyLocation プロパティの形式は DeploymentManifestPath|SolutionID となります。たとえば、次のような文字列になります。

    file://deployserver/MyShare/ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9

  • ソリューションを Visual Studio から実行またはデバッグする場合、_AssemblyLocation プロパティの形式は DeploymentManifestName|SolutionID|vstolocal となります。たとえば、次のような文字列になります。

    ExcelWorkbook1.vsto|74744e4b-e4d6-41eb-84f7-ad20346fe2d9|vstolocal

SolutionID は、Visual Studio Tools for Office ランタイムがソリューションを特定するために使用する GUID です。SolutionID は、プロジェクトをビルドすると自動的に生成されます。vstolocal は、Visual Studio Tools for Office ランタイムに対し、アセンブリを同じフォルダからドキュメントとして読み込む必要があることを指示します。

Microsoft Office 2003 ソリューションのカスタム プロパティ

  • _AssemblyName

    このプロパティにはアスタリスク (*) が含まれます。これは、Microsoft Office アプリケーションに対し、ドキュメントに Visual Studio Tools for Office カスタマイズが含まれることを示します。

  • _AssemblyLocation

    このプロパティには実行時のストレージ コントロールの GUID が含まれます。詳細については、「実行時のストレージ コントロールの概要」を参照してください。

参照

処理手順

方法 : ClickOnce を使用して Office ソリューションを配置する (2007 システム)

方法 : カスタム ドキュメント プロパティを作成および変更する

概念

ドキュメント レベルのカスタマイズのアーキテクチャ

実行時のストレージ コントロールの概要

Office ソリューションにおけるアプリケーション マニフェストと配置マニフェスト

その他の技術情報

Visual Studio Tools for Office ソリューションのアーキテクチャ