Visual Studio Tools for Office ランタイムの ServerDocument クラスを使用すると、Microsoft Office Word と Microsoft Office Excel がインストールされていない場合でも、ドキュメント レベルのカスタマイズのいくつかの側面を管理できます。 実行できるタスクは次のとおりです。
ドキュメントまたはブックのデータ キャッシュ内のデータにアクセスして変更します。 詳細については、「 ドキュメント内のキャッシュされたデータを操作する」を参照してください。
ドキュメントに関連付けられているカスタマイズ アセンブリを管理します。 詳細については、「 ドキュメントのカスタマイズの管理」を参照してください。
適用対象: このトピックの情報は、Excel および Word のドキュメント レベルのプロジェクトに適用されます。 詳細については、「 Office アプリケーションとプロジェクトの種類で使用できる機能」を参照してください。
ServerDocument クラスについて
ServerDocument クラスは、Office がインストールされていないコンピューターで使用するように設計されています。 そのため、通常、このクラスは、Office プロジェクトではなくコンソール プロジェクトや Windows フォーム プロジェクトなど、Office と統合されないアプリケーションで使用します。 Microsoft.VisualStudio.Tools.Applications.ServerDocument.dllServerDocument クラスを使用します。
ServerDocument クラスは、Visual Studio 2013 を使用して作成されたドキュメント レベルのカスタマイズを操作するために使用できます。
Visual Studio 2010 Tools for Office Runtime と .NET Framework の Office 拡張機能の詳細については、「 Visual Studio Tools for Office ランタイムの概要」を参照してください。
注
ServerDocument システム (バージョン 3.0 ランタイム) で Visual Studio Tools for Office クラスを使用するレガシ アプリケーションがある場合は、アプリケーションを実行するコンピューターにVisual Studio Tools for Office システム (バージョン 3.0 ランタイム) をインストールする必要があります。
Visual Studio 2010 Tools for Office runtimeはこれらのアプリケーションを実行できません。
ドキュメント内のキャッシュされたデータを操作する
ServerDocument クラスは、カスタマイズされたドキュメントのデータ キャッシュの操作に使用できるメンバーを提供します。 キャッシュされたデータの詳細については、「キャッシュ データ」および「サーバー上のドキュメント内のデータにアクセスする」を参照してください。
次の表に、キャッシュされたデータの操作に使用できるメンバーを示します。
| Task | 使用するメンバー |
|---|---|
| ドキュメントにデータ キャッシュがあるかどうかを判断します。 | IsCacheEnabled メソッド。 |
| ドキュメント内のキャッシュされたデータにアクセスする。 詳細については、 サーバー上のドキュメント内のデータへのアクセスを参照してください。 |
CachedData プロパティ。 |
ドキュメントのカスタマイズを管理する
ServerDocument クラスのメンバーを使用して、ドキュメントに関連付けられているカスタマイズ アセンブリを管理できます。 たとえば、プログラムを使用してドキュメントからカスタマイズを削除して、ドキュメントがカスタマイズの一部でなくなったようにすることができます。
次の表に、カスタマイズ アセンブリの管理に使用できるメンバーを示します。
| Task | 使用するメンバー |
|---|---|
| ドキュメントがドキュメント レベルのカスタマイズの一部であるかどうかを判断します。 | GetCustomizationVersion メソッド。 |
| 実行時にカスタマイズをドキュメントにプログラムでアタッチする。 詳細については、「方法: マネージド コード拡張機能をドキュメントにアタッチする」を参照してください。 |
AddCustomizationメソッドの 1 つ。 |
| 実行時にドキュメントからカスタマイズをプログラムで削除する。 詳細については、「 方法: ドキュメントからマネージド コード拡張機能を削除する」を参照してください。 |
RemoveCustomization メソッド。 |
| ドキュメントに関連付けられている配置マニフェストの URL を取得します。 | DeploymentManifestUrl プロパティ。 |