Udostępnij za pośrednictwem

Usuwanie rozszerzeń kodu zarządzanego z dokumentów

  • Artykuł

Zestaw dostosowywania można programowo usunąć z dokumentu lub skoroszytu, który jest częścią dostosowywania na poziomie dokumentu dla programu Microsoft Office Word lub Microsoft Office Excel. Użytkownicy mogą następnie otwierać dokumenty i wyświetlać zawartość, ale żaden niestandardowy interfejs użytkownika dodany do dokumentów nie będzie wyświetlany, a kod nie zostanie uruchomiony.

Dotyczy: informacje w tym temacie dotyczą projektów na poziomie dokumentu dla programów Excel i Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Zestaw dostosowywania można usunąć przy użyciu jednej z metod udostępnianych RemoveCustomization przez środowisko uruchomieniowe Visual Studio Tools dla pakietu Office . Używana metoda zależy od tego, czy chcesz usunąć dostosowanie w czasie wykonywania (czyli uruchamiając kod w dostosowywaniu, gdy dokument programu Word lub skoroszyt programu Excel jest otwarty), czy też chcesz usunąć dostosowanie z zamkniętego dokumentu lub dokumentu, który znajduje się na serwerze, na którym nie zainstalowano pakietu Microsoft Office.

Aby usunąć zestaw dostosowywania w czasie wykonywania

  1. W kodzie dostosowywania wywołaj metodę RemoveCustomization (dla programu Word) lub metodę RemoveCustomization (dla programu Excel). Ta metoda powinna być wywoływana tylko po tym, jak dostosowanie nie jest już potrzebne.

    Sposób wywoływania tej metody w kodzie zależy od sposobu użycia dostosowania. Jeśli na przykład klienci korzystają z funkcji dostosowywania, dopóki nie będą gotowi do wysłania dokumentu do innych klientów, którzy potrzebują tylko samego dokumentu (a nie dostosowania), możesz podać interfejs użytkownika, który wywołuje RemoveCustomization , gdy klient kliknie go. Alternatywnie, jeśli dostosowanie wypełni dokument danymi po pierwszym otwarciu, ale dostosowanie nie udostępnia żadnych innych funkcji, do których uzyskują dostęp bezpośrednio klienci, możesz wywołać metodę RemoveCustomization, gdy tylko dostosowanie zakończy inicjowanie dokumentu.

Aby usunąć zestaw dostosowywania z zamkniętego dokumentu lub dokumentu na serwerze

  1. W projekcie, który nie wymaga pakietu Microsoft Office, takiego jak aplikacja konsolowa lub projekt Windows Forms, dodaj odwołanie do zestawu Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll .

  2. Dodaj następującą instrukcję Import lub using na początku pliku kodu.

    using Microsoft.VisualStudio.Tools.Applications;

  3. Wywołaj metodę ServerDocument statyczną RemoveCustomization klasy i określ ścieżkę dokumentu rozwiązania dla parametru .

    Poniższy przykład kodu zakłada, że usuwasz dostosowanie z dokumentu o nazwie WordDocument1.docx , który znajduje się na pulpicie.

    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, na którym chcesz usunąć dostosowanie. Na komputerze musi być zainstalowany program Visual Studio 2010 Tools for Office Runtime.

Powiązana zawartość