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

Sestavení vlastního nastavení můžete programově odebrat z dokumentu nebo sešitu, který je součástí přizpůsobení úroveň dokument pro aplikaci Microsoft Office Word nebo Microsoft Office Excel.Uživatelé pak dokumenty otevřít a zobrazit obsah, ale nezobrazí se žádné vlastní uživatelské rozhraní (UI), přidat dokumenty a kód nebude spuštěn.

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.

Sestavení vlastního nastavení můžete odebrat pomocí jedné z RemoveCustomization metody poskytované Visual Studio Tools for Office runtime.Jaký způsob použijete, závisí na tom, zda chcete odebrat vlastní nastavení za běhu (spuštěním kódu v přizpůsobení při slovo dokument nebo sešit aplikace Excel je otevřít), nebo pokud chcete odebrat vlastní nastavení ze zavřeného dokumentu nebo dokumentu, který je na serveru, který nemá nainstalován Microsoft Office.

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

Odebrání vlastního nastavení sestavení v době běhu

• Ve vlastním kódu, zavolejte Document.RemoveCustomization metoda (Word) nebo Workbook.RemoveCustomization metoda (pro Excel).Tato metoda měla být volána pouze po přizpůsobení již není potřeba.

  Kdy volat tuto metodu v kódu závisí na způsobu použití vlastní.Například pokud zákazníci své vlastní funkce používat, dokud budou připraveny k odeslání dokumentu jiným klientům, které potřebujete pouze samotného (ne vlastní) dokumentu, můžete zadat některé uživatelské rozhraní, která volá RemoveCustomization Pokud zákazník klikne.Případně pokud vlastní naplní dokument s dat při prvním otevření, ale přizpůsobení neposkytuje další funkce, které k nim přímo zákazníkům, pak můžete volat RemoveCustomization jako vlastní dokončení inicializace dokumentu.

Odebrání vlastního nastavení sestavení ze zavřeného dokumentu nebo dokumentu na serveru

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.

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

   Imports Microsoft.VisualStudio.Tools.Applications
   

   using Microsoft.VisualStudio.Tools.Applications;
   

3. Zavolejte statickou RemoveCustomization metoda ServerDocument třídy a zadat cestu dokumentu řešení pro parametr.

   Následující příklad kódu předpokládá, že jsou odebrání vlastního nastavení z dokumentu s názvem WordDocument1.docx 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)
       If runtimeVersion = 3 Then
           ServerDocument.RemoveCustomization(documentPath)
           System.Windows.Forms.MessageBox.Show("The customization has been removed.")
       End If 
   Catch ex As FileNotFoundException
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.")
   Catch ex As IOException
       System.Windows.Forms.MessageBox.Show("The specified document is read-only.")
   Catch ex As InvalidOperationException
       System.Windows.Forms.MessageBox.Show("The customization could not be removed." & _
           vbLf & ex.Message)
   End Try
   

   string documentPath = System.Environment.GetFolderPath(
       Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
   int runtimeVersion = 0;
   
   try
   {
       runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);
   
       if (runtimeVersion == 3)
       {
           ServerDocument.RemoveCustomization(documentPath);
           System.Windows.Forms.MessageBox.Show("The customization has been removed.");
       }
   }
   catch (FileNotFoundException)
   {
       System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
   }
   catch (IOException)
   {
       System.Windows.Forms.MessageBox.Show("The specified document is read-only.");
   }
   catch (InvalidOperationException ex)
   {
       System.Windows.Forms.MessageBox.Show("The customization could not be removed.\n" +
           ex.Message);
   }
   

4. Sestavte projekt a spusťte aplikaci v počítači, kde chcete odebrat vlastní nastavení.Počítač musí mít nástroje sady Visual Studio 2010 Runtime Office nainstalována.

Viz také

Úkoly

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

Koncepty

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