Postupy: Připojení rozšíření spravovaného kódu k dokumentům

Sestavení vlastního nastavení můžete připojit k existující dokument Microsoft Office Word nebo sešit aplikace Microsoft Office Excel.Dokument nebo sešit může být v libovolném formátu souboru, je podporován projekty Microsoft Office a vývojářských nástrojů v aplikaci Visual Studio.Další informace naleznete v tématu Architektura přizpůsobení na úrovni dokumentu.

Platí pro: Informace v tomto tématu se vztahují na projekty na úrovni dokumentu v těchto aplikacích: Excel 2013 a Excel 2010; Word 2013 a Word 2010. Další informace najdete v tématu Dostupné funkce podle aplikací systému Office a typů projektu.

O přizpůsobení připojit k dokumentu aplikace Word nebo Excel, použijte AddCustomization metoda ServerDocument třídy.Protože ServerDocument třídy je určen ke spuštění v počítači, který nemá nainstalován Microsoft Office, můžete použít tuto metodu v řešení, které přímo nesouvisí se vývoj Microsoft Office (například konzoly nebo model Windows Forms aplikace).

[!POZNÁMKA]

Přizpůsobení se nepodaří načíst kód očekává ovládací prvky, které nemá zadaný dokument.

Související video ukázku naleznete v tématu jak udělat i připojit nebo odpojit VSTO sestavení z dokumentu aplikace Word?.

K dokumentu připojit rozšíření spravovaný kód

1. V projektu, který nevyžaduje Microsoft Office, jako je aplikace konzoly nebo v model Windows Forms projektu přidejte odkaz na sestavení Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll a Microsoft.VisualStudio.Tools.Applications.Runtime.dll.

2. Přidejte následující Imports nebo using příkazů na začátek souboru kódu.

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

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

3. Zavolejte statickou AddCustomization metoda.

   Následující příklad kódu používá AddCustomization přetížení.Toto přetížení přijímá úplnou cestu dokumentu a Uri , který určuje umístění manifestu nasazení vlastního nastavení, které chcete připojit k dokumentu.Tento příklad předpokládá, že dokument aplikace Word s názvem WordDocument1.docx je na ploše a manifest nasazení je umístěn ve složce s názvem Publikovat , je také na ploše.

   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. Sestavte projekt a spusťte aplikaci v počítači, kde chcete připojit vlastní nastavení.Počítač musí mít nástroje sady Visual Studio 2010 Runtime Office nainstalována.

Viz také

Úkoly

Postupy: Odebrání rozšíření spravovaného kódu z dokumentů

Koncepty

Správa dokumentů na serveru s použitím třídy ServerDocument

Manifesty aplikací a nasazení v řešeních pro systém Office