使用 ServerDocument 類別管理伺服器上的文件

發行項
08/21/2008

更新：2007 年 11 月

適用於
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。專案類型文件層級專案 Microsoft Office 版本 2007 Microsoft Office system Microsoft Office 2003 如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

文件層級專案

Microsoft Office 版本

2007 Microsoft Office system
Microsoft Office 2003

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

您可以透過 ServerDocument 類別來管理數個文件層級的自訂作業，即使尚未安裝 Microsoft Office Word 和 Microsoft Office Excel 也沒關係。您可以執行下列工作：

存取和修改文件或活頁簿之資料快取中的資料。如需詳細資訊，請參閱使用文件中的快取資料。
管理文件中的 Visual Studio Tools for Office 自訂。如需詳細資訊，請參閱管理文件自訂。

了解 ServerDocument 類別

ServerDocument 類別可分為兩種不同的版本，每一種各適用於一種 Visual Studio Tools for Office Runtime 版本。請使用與 Microsoft Office 版本適用的方案對應之類別：

如果是 Excel 2007 和 Word 2007 的自訂，請使用 Microsoft.VisualStudio.Tools.Applications.ServerDocument 類別。這個類別是由 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 所提供。
如果是 Excel 2003 和 Word 2003 的自訂，請使用 Microsoft.VisualStudio.Tools.Applications.Runtime.ServerDocument 類別。這個類別是由 Visual Studio 2005 Tools for Office Second Edition Runtime 所提供。

雖然這兩種版本的 ServerDocument 類別幾乎擁有相同的功能，但在命名空間 (Namespace)、組件 (Assembly) 與成員上還是有些差異。如需詳細資訊，請參閱了解 ServerDocument 差異。

ServerDocument 類別主要是用在未安裝 Microsoft Office 的電腦上。因此，一般您會在未與 Microsoft Office 整合的專案 (例如主控台專案或 Windows Form 專案，而不是在 Visual Studio Tools for Office 專案) 中使用這個類別。

如需不同版本的 Visual Studio Tools for Office Runtime 的詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

使用文件中的快取資料

兩種版本的 ServerDocument 類別中都有成員可供您處理自訂文件中的資料快取。如需快取資料的詳細資訊，請參閱快取資料和存取伺服器文件中的資料。

下表列出您可用來處理快取資料的成員。

工作	Excel 2007 和 Word 2007 專案	Excel 2003 和 Word 2003 專案
若要判斷文件是否具有 Visual Studio Tools for Office 資料快取。	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 IsCacheEnabled 方法。	Visual Studio 2005 Tools for Office Second Edition Runtime 中的 IsCacheEnabled 方法。
若要存取文件中的快取資料。如需詳細資訊，請參閱存取伺服器文件中的資料。	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 CachedData 屬性。	Visual Studio 2005 Tools for Office Second Edition Runtime 中的 CachedData 屬性。

若要判斷文件是否具有 Visual Studio Tools for Office 資料快取。

Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 IsCacheEnabled 方法。

Visual Studio 2005 Tools for Office Second Edition Runtime 中的 IsCacheEnabled 方法。

若要存取文件中的快取資料。

如需詳細資訊，請參閱存取伺服器文件中的資料。

Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 CachedData 屬性。

Visual Studio 2005 Tools for Office Second Edition Runtime 中的 CachedData 屬性。

管理文件自訂

您可以透過 ServerDocument 類別的成員來管理文件中的 Visual Studio Tools for Office 自訂。例如，您可以程式設計方式從文件中移除自訂，這樣一來文件就不再屬於 Visual Studio Tools for Office 自訂的一部分。

下表列出您可用來管理自訂組件的成員。

工作	Excel 2007 和 Word 2007 專案	Excel 2003 和 Word 2003 專案
若要判斷文件是否具有 Visual Studio Tools for Office 自訂。	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 GetCustomizationVersion 方法。	Visual Studio 2005 Tools for Office Second Edition Runtime 中的 IsCustomized 方法。
若要以程式設計方式在執行階段將自訂附加至文件。如需詳細資訊，請參閱： HOW TO：將 Managed 程式碼擴充附加至文件 (2007 系統) HOW TO：將 Managed 程式碼擴充附加至文件 (2003 系統)	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的其中一個 AddCustomization 方法。	Visual Studio 2005 Tools for Office Second Edition Runtime 中的其中一個 AddCustomization 方法。
若要以程式設計方式在執行階段從文件中移除自訂。如需詳細資訊，請參閱： HOW TO：從文件移除 Managed 程式碼擴充 (2007 系統) HOW TO：從文件移除 Managed 程式碼擴充 (2003 系統)	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 RemoveCustomization 方法。	Visual Studio 2005 Tools for Office Second Edition Runtime 中的 RemoveCustomization 方法。
若要取得與文件關聯之部署資訊清單的 URL。	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 DeploymentManifestUrl 屬性。	Visual Studio 2005 Tools for Office Second Edition Runtime 不包含這個屬性，因為在 Excel 2003 和 Word 2003 的文件層級方案中，部署資訊清單是選擇性的項目。但是，這些方案一定會有內嵌應用程式資訊清單。
若要存取內嵌在文件中的應用程式資訊清單。	Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 不包含這個屬性，因為 Excel 2007 和 Word 2007 的文件層級方案沒有內嵌應用程式資訊清單。	Visual Studio 2005 Tools for Office Second Edition Runtime 中的 AppManifest 屬性。

了解 ServerDocument 差異

兩種版本的 ServerDocument 類別，以及負責為快取資料提供物件模型的相關類別 (例如 CachedDataHostItem 和 CachedDataItem)，都是在不同的組件和命名空間中定義的。此外，有些成員和方法多載只會透過其中一種版本的類別來提供。在下列情況中，您應當要留心這些差異：

您希望移轉使用 Visual Studio 2005 Tools for Office Second Edition Runtime 中之 ServerDocument 類別的程式碼，以運用於 Excel 2007 和 Word 2007 方案中。
您希望讓程式碼中用於處理文件層級自訂的 ServerDocument 類別，能夠同時適用於 Microsoft Office 2003 和 2007 Microsoft Office system。

如需示範如何在同一個程式碼檔中同時使用這兩種版本的 ServerDocument 類別的範例，請參閱 HOW TO：撰寫使用 ServerDocument 類別兩個版本的程式碼。

命名空間與組件差異

下表列出這兩種版本之 ServerDocument 類別的命名空間和組件差異，以及負責為快取資料提供物件模型的類別。

執行階段版本	命名空間	組件
Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版)	Microsoft.VisualStudio.Tools.Applications	Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll
Visual Studio 2005 Tools for Office Second Edition Runtime	Microsoft.VisualStudio.Tools.Applications.Runtime	Microsoft.VisualStudio.Tools.Applications.Runtime.dll

成員差異

下列成員只能透過 Microsoft Visual Studio Tools for the Microsoft Office system (Runtime 3.0 版) 中的 ServerDocument 類別來提供：

下列成員只能透過 Visual Studio 2005 Tools for Office Second Edition Runtime 中的 ServerDocument 類別來提供：

請參閱

共用方式為