Visual Studio Tools for Office Runtime 概觀
更新：2007 年 11 月
若要執行使用 Visual Studio Tools for Office 建立的方案，則使用者電腦上必須要有 Visual Studio Tools for Office Runtime。這個執行階段包含的 Managed 組件 (Assembly) 和 Unmanaged 元件的作用如下：Managed 組件可以提供您的方案與 Microsoft Office 應用程式之間的通訊層，而應用程式則會使用 Unmanaged 元件來載入您的方案。
如需在使用者電腦上安裝執行階段的詳細資訊，請參閱 HOW TO：安裝 Visual Studio Tools for Office Runtime。
本主題提供下列資訊：
了解不同的執行階段版本
了解執行階段組件
了解執行階段載入器元件
了解不同的執行階段版本
不同 Microsoft Office 版本的 Visual Studio Tools for Office 方案需要不同的執行階段版本。執行階段版本是根據建立方案的專案範本決定，而不是根據執行方案的 Office 版本決定。
下表顯示在使用者電腦上執行方案所需要的執行階段和 Microsoft Office 版本。
專案範本版本 |
使用者電腦上必須要有的 Visual Studio Tools for Office Runtime 版本 |
使用者電腦上可以執行方案的 Microsoft Office 版本 |
|---|---|---|
2007 Microsoft Office system 的專案 |
Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) |
2007 Microsoft Office system |
Microsoft Office 2003 的專案 |
Visual Studio 2005 Tools for Office Second Edition Runtime |
2007 Microsoft Office system Microsoft Office 2003 |
在您安裝 Microsoft Visual Studio Tools for the Microsoft Office system (3.0 版) 時，會在開發電腦上自動安裝這兩種版本的執行階段。
如需建立可以與兩種 Microsoft Office 版本搭配執行之方案的詳細資訊，請參閱建立適用於多個 Microsoft Office 版本的方案。
每個執行階段版本所含的組件會有一些不同。如需詳細資訊，請參閱組件差異。
.gif "注意事項") 注意事項： |
|---|
Visual Studio 2005 Tools for Office Second Edition Runtime 一開始是與 Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office System (VSTO 2005 SE) 一起發行。而使用 Microsoft Visual Studio Tools for the Microsoft Office system (3.0 版) 建立的 Microsoft Office 2003 方案，也會使用這版的執行階段。 |
尋找這兩個執行階段的參考文件
當您按一下「說明」中的連結或索引項目，以取得命名空間 (Namespace)、型別或成員的參考資訊時，可能會得到兩個幾乎相同的結果。這兩版執行階段的主題記載著兩相同的成員。請選取有適當版本標示的主題：
2007 系統。這指的是 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版)。
2003 系統。這指的是 Visual Studio 2005 Tools for Office Second Edition Runtime。
了解執行階段組件
Visual Studio Tools for Office Runtime 所含的組件提供下列種類的類別 (Class)：
方案用來自動化和擴充主應用程式 (Host Application) 的類別。
方案與主應用程式通訊時所透過的基礎結構類別。
| 注意事項： |
|---|
建立專案時，Visual Studio Tools for Office 會自動加入該專案類型使用的組件參考。有些組件僅能用於文件層級專案，有些則僅能用於應用程式層級專案。 |
Visual Studio Tools for Office 3.0 Runtime 的組件
下表列出 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 所含的組件。這版的執行階段是供針對 2007 Microsoft Office system 建立的方案使用。
如需這些組件中之命名空間和類別的文件，請參閱 2007 系統 Managed 參考。
組件名稱 |
說明 |
|---|---|
Microsoft.Office.Tools.Common.v9.0.dll |
提供下列類別：
|
Microsoft.Office.Tools.Excel.v9.0.dll |
提供 Excel 文件層級自訂的主項目和主控制項。如需詳細資訊，請參閱主項目和主控制項概觀。 |
Microsoft.Office.Tools.Outlook.v9.0.dll |
提供可以用來在 Outlook 增益集中建立自訂表單區域的類別。 |
Microsoft.Office.Tools.Word.v9.0.dll |
提供 Word 文件層級自訂的主項目和主控制項。如需詳細資訊，請參閱主項目和主控制項概觀。 |
Microsoft.Office.Tools.v9.0.dll |
提供下列類別：
|
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll |
提供下列類別：
|
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll |
提供下列類別：
|
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll |
提供下列類別：
|
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll |
提供屬於 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 基礎結構一部分的類別。這些類別不適合直接使用於您的程式碼。 |
Visual Studio 2005 Tools for Office Second Edition Runtime 的組件
下表列出 Visual Studio 2005 Tools for Office Second Edition Runtime 所含的組件。這版的執行階段是供針對 Microsoft Office 2003 建立的方案使用。
如需這些組件中之命名空間和類別的說明，請參閱 2003 系統 Managed 參考。
組件名稱 |
說明 |
|---|---|
Microsoft.Office.Tools.Common.dll |
提供下列類別：
|
Microsoft.Office.Tools.Excel.dll |
提供 Excel 文件層級自訂的主項目和主控制項。如需詳細資訊，請參閱主項目和主控制項概觀。 |
Microsoft.Office.Tools.Word.dll |
提供 Word 文件層級自訂的主項目和主控制項。如需詳細資訊，請參閱主項目和主控制項概觀。 |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
提供下列類別：
|
組件差異
Visual Studio 2005 Tools for Office Second Edition Runtime 所含的數個組件在 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中具有不同的名稱。此外，有一個屬於 Visual Studio 2005 Tools for Office Second Edition Runtime 一部分的組件已經分割為 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的數個新組件。
下表列出差異。
Visual Studio 2005 Tools for Office Second Edition Runtime 中的組件名稱 |
Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的組件名稱 |
|---|---|
Microsoft.Office.Tools.Common.dll |
Microsoft.Office.Tools.Common.v9.0.dll |
Microsoft.Office.Tools.Excel.dll |
Microsoft.Office.Tools.Excel.v9.0.dll |
Microsoft.Office.Tools.Word.dll |
Microsoft.Office.Tools.Word.v9.0.dll |
Microsoft.VisualStudio.Tools.Applications.Runtime.dll |
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll 部分類別已移至下列新的組件中：
|
了解執行階段載入器元件
Visual Studio Tools for Office Runtime 包含 Microsoft Office 應用程式用來載入 Visual Studio Tools for Office 方案的數個 Unmanaged DLL。雖然您應該永遠都不需要直接使用這些 DLL，但是知道這些 DLL 的用途有助於深入了解 Visual Studio Tools for Office 方案的架構。
如需在載入程序期間如何使用這些元件的詳細資訊，請參閱文件層級自訂的架構和應用程式層級增益集的架構。
執行階段載入器
使用者開啟文件層級自訂或啟動增益集時，Microsoft Office 應用程式會呼叫執行階段載入器。這個元件的名稱是 VSTOEE.dll。
執行階段載入器可確保 Microsoft Office 版本載入增益集時，會載入正確的 Visual Studio Tools for Office Runtime 版本。雖然相同電腦上可以安裝多個 Visual Studio Tools for Office Runtime 版本，但是一次只能安裝一個 VSTOEE.dll 執行個體 (Instance)。這是電腦上安裝的最新版執行階段所含的 VSTOEE.dll。
方案載入器
方案載入器會執行在載入方案組件時需要進行的大部分工作。方案載入器會根據 Visual Studio Tools for Office Runtime 的版本，而有不同的檔名。Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的方案載入器名稱是 VSTOLoader.dll。它在 Visual Studio 2005 Tools for Office Second Edition Runtime 中的名稱則是 AddinLoader.dll。
方案載入器會進行幾項工作：
為每個 Visual Studio Tools for Office 方案組件建立新的應用程式定義域。
執行一組安全性檢查，確認增益集組件具有執行權限。
方案載入器也會進行增益集特有的幾項工作：
實作 IDTExtensibility2 介面。IDTExtensibility2 是所有 Microsoft Office 應用程式增益集都必須實作的 COM 介面。這個介面定義了應用程式要與增益集通訊時，所呼叫的方法。
實作 IManagedAddin 介面。自 2007 版開始的 Office 應用程式會使用這個介面協助載入 Visual Studio Tools for Office 增益集。如需詳細資訊，請參閱 IManagedAddin 介面。
請參閱
工作
HOW TO：安裝 Visual Studio Tools for Office Runtime
HOW TO：建立 Visual Studio Tools for Office 專案