Jak: dołączanie rozszerzeń kod zarządzany do dokumentów

Montaż dostosowywania można dołączyć do istniejącego dokumentu programu Microsoft Office Word lub skoroszytu programu Microsoft Office Excel.Dokument lub skoroszyt może być w dowolnym formacie, który jest obsługiwany przez projekty programu Microsoft Office i narzędzia programistyczne w programie Visual Studio.Aby uzyskać więcej informacji, zobacz Architektura dostosowań na poziomie dokumentu.

Dotyczy: Informacje przedstawione w tym temacie dotyczą projektów na poziomie dokumentu dla następujących aplikacji: Excel 2013 i Excel 2010; Word 2013 i Word 2010. Aby uzyskać więcej informacji, zobacz Funkcje dostępne w aplikacji pakietu Office i typ projektu.

Aby dołączyć dostosowań do dokumentu programu Word lub Excel, należy użyć AddCustomization metoda ServerDocument klasy.Bo ServerDocument klasy jest przeznaczony do uruchomienia na komputerze bez zainstalowanego programu Microsoft Office zainstalowany, można użyć tej metody w rozwiązania, które nie są bezpośrednio związane z rozwoju programu Microsoft Office (na przykład konsoli lub Windows Forms aplikacji).

[!UWAGA]

Dostosowanie nie będzie można załadować, jeśli kod oczekuje formantów, które nie ma określonego dokumentu.

Aby wyświetlić pokrewne wideo demonstracyjne, zobacz jak I: czy dołączać lub odłączania zestawu VSTO z dokumentu programu Word?.

Aby dołączyć kod zarządzany rozszerzeń do dokumentu

1. Dodawanie odwołania do zespołów Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll i Microsoft.VisualStudio.Tools.Applications.Runtime.dll projekt, który nie wymaga programu Microsoft Office, takich jak aplikacja konsoli lub Windows Forms projektu.

2. Dodaj następujący Imports lub using instrukcji do początku pliku kodu.

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

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

3. Wywołanie statycznej AddCustomization metoda.

   Następujący kod w przykładzie wykorzystano AddCustomization na przeciążenie.Przeciążenie tego bierze pełną ścieżkę do dokumentu i Uri , który określa lokalizację manifestu wdrażania dla dostosowania, które chcesz dołączyć do dokumentu.W tym przykładzie założono, że dokument programu Word o nazwie WordDocument1.docx na pulpicie, i że manifest wdrożenia znajduje się w folderze o nazwie Opublikuj to również na pulpicie.

   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. Skompiluj projekt i uruchom aplikację na komputerze, gdzie chcesz dołączyć dostosowywania.Komputer musi mieć narzędzia Visual Studio 2010 Runtime Office zainstalowany.

Zobacz też

Zadania

Jak: usunięcie kodu zarządzanego rozszerzeń dokumentów

Koncepcje

Zarządzanie dokumentami na serwerze za pomocą klasy ServerDocument

Aplikacja i manifestów wdrażania rozwiązań pakietu Office