Porady: usuwanie rozszerzenia kodu zarządzanego z dokumentów

Zgromadzenie dostosowywania można programowo usunąć z dokumentu lub skoroszyt, który jest częścią dostosowywania poziomie dokumentu dla programu Microsoft Office Word lub Microsoft Office Excel.Użytkownicy mogą otwierać dokumenty i wyświetlić zawartość, ale nie pojawią się wszystkie niestandardowego interfejsu użytkownika (UI) dodać do dokumentów i Twój kod nie będzie działać.

Zastosowanie: Informacje przedstawione w tym temacie mają zastosowanie do 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 aplikacjach pakietu Office i typ projektu.

Montaż dostosowywania można usunąć za pomocą jednego z RemoveCustomization metod dostarczonych przez Visual Studio Tools for Office Runtime.Wybór metody zależy od tego, czy chcesz usunąć dostosowania w czasie wykonywania (to znaczy przez uruchomienie kodu w dostosowywania, podczas gdy słowo dokument lub skoroszyt programu Excel jest otwarty), lub jeśli chcesz usunąć dostosowanie z zamkniętych dokumentu lub dokumentu, który znajduje się na serwerze, który nie ma programu Microsoft Office zainstalowany.

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

Aby usunąć zestaw dostosowania w czasie wykonywania

• W kodzie dostosowywania call Document.RemoveCustomization metodę (Word) lub Workbook.RemoveCustomization metoda (dla programu Excel).Metoda ta powinna być wywoływana tylko wtedy, gdy dostosowanie nie jest już potrzebna.

  Gdy wywołanie tej metody w kodzie zależy od tego, jak Twoje dostosowywania jest używany.Na przykład, jeśli klienci używać funkcji swoje dostosowania, dopóki nie są gotowe do wysłania dokumentu do innych klientów, które trzeba tylko dokumentem (nie dostosowywania), można podać kilka interfejsu użytkownika, który wywołuje RemoveCustomization gdy klient kliknie go.Alternatywnie, jeśli Twoje dostosowywania wypełnia dokument z danych przy pierwszym otwarty, ale dostosowanie nie dostarcza innych funkcji, które są dostępne bezpośrednio przez klientów, a następnie można wywołać RemoveCustomization tak szybko, jak Twoje dostosowywania kończy inicjowanie dokumentu.

Aby usunąć zestawu dostosowywania z zamkniętych dokumentu lub dokumentu na serwerze

1. W projekt, który nie wymaga programu Microsoft Office, takich jak aplikacja konsoli lub Windows Forms projektu należy dodać odwołanie do zestawu Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll.

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

   Imports Microsoft.VisualStudio.Tools.Applications
   

   using Microsoft.VisualStudio.Tools.Applications;
   

3. Wywołanie statycznej RemoveCustomization metoda ServerDocument klasy i określ ścieżkę dokumentu rozwiązanie dla parametru.

   W poniższym przykładzie kodu zakłada usunięcie dostosowywania z dokumentu o nazwie WordDocument1.docx to na pulpicie.

   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. Skompiluj projekt i uruchom aplikację na komputerze, w której chcesz usunąć dostosowanie.Komputer musi mieć narzędzia Visual Studio 2010 Runtime Office zainstalowany.

Zobacz też

Zadania

Porady: Dołączanie rozszerzenia kodu zarządzanego do dokumentów

Koncepcje

Zarządzanie dokumentami na serwerze za pomocą klasy ServerDocument