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

您可以將自訂組件附加至現有的 Microsoft Office Word 文件或 Microsoft Office Excel 活頁簿。文件或活頁簿可以在 Microsoft Office 專案和開發工具支援在 Visual Studio 的任何檔案格式。如需詳細資訊，請參閱文件層級自訂的架構。

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

若要將自訂附加至 Word 或 Excel 文件，請使用 ServerDocument 類別的 AddCustomization 方法。由於 ServerDocument 類別的設計是在未安裝 Microsoft Office 的電腦上執行，因此您可以在未與 Microsoft Office 開發工作 (例如主控台或 Windows Form 應用程式) 直接相關的方案中使用這個方法。

注意事項
如果程式碼預期收到指定文件未擁有的控制項時，自訂就會失敗。

如需觀看相關示範影片，請參閱如何在 Word 文件中附加或中斷連結 VSTO 組件？(英文)。

若要將 Managed 程式碼擴充附加至文件

1. 在不需要 Microsoft Office，例如主控台應用程式或 Windows Form 專案，將 Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll 和 Microsoft.VisualStudio.Tools.Applications.Runtime.dll 組件的參考。

2. 將下列 Imports 或 using 陳述式加入至程式碼檔的最上方。

   Imports Microsoft.VisualStudio.Tools.Applications
   Imports Microsoft.VisualStudio.Tools.Applications.Runtime
   

   using Microsoft.VisualStudio.Tools.Applications;
   using Microsoft.VisualStudio.Tools.Applications.Runtime;
   

3. 呼叫靜態 AddCustomization 方法。

   下列程式碼範例會使用 AddCustomization 多載。這項多載採用文件的完整路徑以及 Uri，後者指定了您要附加至文件的自訂之部署資訊清單位置。此範例假定名為 WordDocument1.docx 的 Word 文件位於桌面上，且部署資訊清單位於名為 Publish 的資料夾中 (同樣位於桌面)。

   Dim documentPath As String = System.Environment.GetFolderPath( _
        Environment.SpecialFolder.Desktop) + "\WordDocument1.docx"
   Dim runtimeVersion As Integer = 0
   
   Try
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath)
   
       ' Make sure that this document does not yet have any Visual Studio Tools 
       ' for Office customizations.
       If runtimeVersion = 0 Then
           Dim deployManifestPath As String = System.Environment.GetFolderPath( _
               Environment.SpecialFolder.Desktop) & "\Publish\WordDocument1.vsto"
           Dim deploymentManifestUri As New Uri(deployManifestPath)
           ServerDocument.AddCustomization(documentPath, deploymentManifestUri)
           System.Windows.Forms.MessageBox.Show("The document was successfully customized.")
       Else
           System.Windows.Forms.MessageBox.Show("The document is already customized.")
       End If
   Catch ex As FileNotFoundException
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
   Catch ex As DocumentNotCustomizedException
       System.Windows.Forms.MessageBox.Show("The document could not be customized." & _
           vbLf & ex.Message)
   End Try
   

   string documentPath = System.Environment.GetFolderPath(
       Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
   int runtimeVersion = 0;
   
   try
   {
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
   
       // Make sure that this document does not yet have any Visual Studio Tools 
       // for Office customizations.
       if (runtimeVersion == 0)
       {
           string deployManifestPath = System.Environment.GetFolderPath(
               Environment.SpecialFolder.Desktop) + @"\Publish\WordDocument1.vsto";
   
           Uri deploymentManifestUri = new Uri(deployManifestPath);
           ServerDocument.AddCustomization(documentPath, deploymentManifestUri);
           System.Windows.Forms.MessageBox.Show("The document was successfully customized.");
       }
       else
       {
           System.Windows.Forms.MessageBox.Show("The document is already customized.");
       }
   }
   catch (FileNotFoundException)
   {
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
   }
   catch (DocumentNotCustomizedException ex)
   {
       System.Windows.Forms.MessageBox.Show("The document could not be customized.\n" +
           ex.Message);
   }
   

4. 在您要附加自訂的電腦上，建置專案並執行應用程式。電腦必須安裝 Visual Studio Visual Studio Tools for Office Runtime 安裝。

請參閱

工作

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

概念

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

Office 方案中的應用程式和部署資訊清單