Sdílet prostřednictvím

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

  • Článek

Sestavení přizpůsobení můžete programově odebrat z dokumentu nebo sešitu, který je součástí přizpůsobení na úrovni dokumentu pro systém Microsoft Office Word nebo systém Microsoft Office Excel. Uživatelé pak můžou dokumenty otevřít a zobrazit obsah, ale nezobrazí se žádné vlastní uživatelské rozhraní, které do dokumentů přidáte, a váš kód se nespustí.

Platí pro: Informace v tomto tématu platí pro projekty na úrovni dokumentu pro Excel a Word. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Sestavení přizpůsobení můžete odebrat pomocí jedné z RemoveCustomization metod poskytovaných nástrojem Visual Studio Tools for Office runtime . Kterou metodu použijete, závisí na tom, jestli chcete odebrat vlastní nastavení za běhu (tj. spuštěním kódu v přizpůsobení, když je wordový dokument nebo excelový sešit otevřený), nebo pokud chcete odebrat vlastní nastavení z uzavřeného dokumentu nebo dokumentu, který je na serveru, který nemá nainstalované systém Microsoft Office.

Odebrání sestavení přizpůsobení za běhu

  1. V kódu vlastního nastavení volejte metodu RemoveCustomization (pro Word) nebo metodu RemoveCustomization (pro Excel). Tato metoda by se měla volat až po tom, co už přizpůsobení není potřeba.

    Způsob volání této metody v kódu závisí na způsobu použití vlastního nastavení. Pokud například zákazníci používají funkce vlastního nastavení, dokud nebudou připravení odeslat dokument jiným klientům, kteří potřebují jenom samotný dokument (ne vlastní nastavení), můžete poskytnout uživatelské rozhraní, které volá RemoveCustomization , když na něj zákazník klikne. Případně pokud vaše přizpůsobení naplní dokument daty při prvním otevření, ale vlastní nastavení neposkytuje žádné další funkce, ke kterým mají přístup přímo zákazníci, můžete volat RemoveCustomization hned po dokončení inicializace dokumentu.

Odebrání sestavení přizpůsobení z uzavřeného dokumentu nebo dokumentu na serveru

  1. V projektu, který nevyžaduje systém Microsoft Office, jako je konzolová aplikace nebo model Windows Forms projekt, přidejte odkaz na sestavení Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll.

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

    using Microsoft.VisualStudio.Tools.Applications;

  3. Zavolejte statickou RemoveCustomization metodu ServerDocument třídy a zadejte cestu k dokumentu řešení pro parametr.

    Následující příklad kódu předpokládá, že odebíráte přizpůsobení z dokumentu s názvem WordDocument1.docx , který je na ploše.

    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, na kterém chcete vlastní nastavení odebrat. Na počítači musí být nainstalované nástroje Visual Studio 2010 Tools for Office Runtime.

Související obsah