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

  • 發行項

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

  • 存取和修改文件或活頁簿之資料快取中的資料。 如需詳細資訊，請參閱使用文件中的快取資料。

  • 管理與文件相關聯的自訂組件。 如需詳細資訊，請參閱管理文件自訂。

**適用於：**本主題中的資訊適用於下列應用程式的文件層級專案：Excel 2007 和 Excel 2010、Word 2007 和 Word 2010。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

了解 ServerDocument 類別

ServerDocument 類別的設計是用於未安裝 Office 的電腦上。 因此，一般您會在未與 Office 整合的應用程式 (例如主控台專案或 Windows Form 專案，而不是 Office 專案) 中使用這個類別。

Visual Studio 2010 Tools for Office Runtime 中有兩種不同版本的 ServerDocument 類別。您應該使用的版本是根據要使用該類別的應用程式中的目標 .NET Framework 而定：

  • 針對目標為 .NET Framework 4 的應用程式，使用 Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll 組件中的 Microsoft.VisualStudio.Tools.Applications.ServerDocument 類別。 

  • 針對目標為 .NET Framework 3.5 的應用程式，使用 Microsoft.VisualStudio.Tools.Applications.ServerDocument.v10.0.dll 組件中的 Microsoft.VisualStudio.Tools.Applications.ServerDocument 類別。

這兩個版本的 ServerDocument 類別都可以在使用 Visual Studio 2010 建立的文件層級自訂上操作，或是在使用 Visual Studio 2008 建立的 Excel 2007 和 Word 2007 文件層級自訂上操作。

如需 Visual Studio 2010 Tools for Office Runtime 和 Office Extensions for .NET Framework 的詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

注意事項注意事項

如果您有舊版應用程式使用 Visual Studio Tools for Office System (Runtime 3.0 版) 中的 ServerDocument 類別，則執行該應用程式的電腦上已必須安裝 Visual Studio Tools for Office System (Runtime 3.0 版)。 Visual Studio 2010 Tools for Office Runtime 無法執行這些應用程式。

使用文件中的快取資料

ServerDocument 類別提供的成員可讓您用來處理自訂文件中的資料快取。 如需快取資料的詳細資訊，請參閱快取資料和存取伺服器文件中的資料。

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

工作

使用的成員

判斷文件是否具有資料快取。

IsCacheEnabled 方法。

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

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

CachedData 屬性。

管理文件自訂

您可以使用 ServerDocument 類別的成員來管理與文件相關聯的自訂組件。 例如，您可以透過程式設計的方式從文件中移除自訂，這樣一來文件就不再屬於自訂的一部分。

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

工作

使用的成員

判斷文件是否屬於文件層級自訂的一部分。

GetCustomizationVersion 方法。

若要以程式設計方式在執行階段將自訂附加至文件。

如需詳細資訊，請參閱 HOW TO：將 Managed 程式碼擴充附加至文件

其中一個 AddCustomization 方法。

若要以程式設計方式在執行階段從文件中移除自訂。

如需詳細資訊，請參閱 HOW TO：從文件移除 Managed 程式碼擴充。

RemoveCustomization 方法。

若要取得與文件關聯之部署資訊清單的 URL。

DeploymentManifestUrl 屬性。

請參閱

工作

HOW TO：將 Managed 程式碼擴充附加至文件

HOW TO：從文件移除 Managed 程式碼擴充

參考

Microsoft.VisualStudio.Tools.Applications.ServerDocument

概念

Visual Studio Tools for Office Runtime 概觀

快取資料