Procedura: rimuovere estensioni di codice gestito da documenti (System 2003)

Articolo
04/28/2010

Aggiornamento: novembre 2007

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di documento Versione Microsoft Office Microsoft Office 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di documento

Versione Microsoft Office

Microsoft Office 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

È possibile rimuovere a livello di codice l'assembly di personalizzazione Visual Studio Tools per Office da un documento o da una cartella di lavoro inclusa in una personalizzazione a livello di documento per Microsoft Office 2003. Gli utenti possono aprire e visualizzare il contenuto dei documenti, ma non sarà possibile visualizzare l'interfaccia utente (UI) personalizzata eventualmente aggiunta e il codice non verrà eseguito. Quando si rimuove l'assembly, è possibile mantenere i dati memorizzati nella cache contenuti nel documento o rimuovere anche questi:

Se si desidera mantenere i dati memorizzati nella cache, cancellare il manifesto di applicazione incorporato nel documento. Potrebbe essere utile mantenere i dati memorizzati nella cache per fare in modo che vengano letti successivamente da una pagina ASP.NET o da un'applicazione server.
Se i dati memorizzati nella cache non sono più necessari, cancellare sia questi che il manifesto di applicazione.

Il runtime Visual Studio Tools per Office include un modello a oggetti che consente di eseguire queste azioni a livello di codice.

Cancellazione del manifesto di applicazione incorporato

Utilizzare la classe ServerDocument per cancellare solo il manifesto dell'applicazione incorporato. È necessario inserire codice che utilizzi la classe ServerDocument in un nuovo progetto, ad esempio in un'applicazione console o un progetto Windows Form, e non nella soluzione Visual Studio Tools per Office.

Per cancellare il manifesto dell'applicazione incorporato

Creare un nuovo progetto, ad esempio un'applicazione console o un progetto Windows Form.
Aggiungere un riferimento all'assembly Microsoft.VisualStudio.Tools.Applications.Runtime.dll nel progetto.

Aggiungere l'istruzione Imports o using seguente all'inizio del file di codice.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime

using Microsoft.VisualStudio.Tools.Applications.Runtime;

Creare un'istanza di ServerDocumente passare il documento della soluzione. Chiamare il metodo Clear della proprietà AppManifest.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("C:\Documents\SolutionDocument.doc")
    sd.AppManifest.Clear()

ServerDocument sd = null;
try 
{
    sd = new ServerDocument(@"C:\Documents\SolutionDocument.doc");
    sd.AppManifest.Clear();

Salvare le modifiche e chiudere il documento.

    sd.Save()

Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Cancellazione del manifesto di applicazione incorporato e dei dati memorizzati nella cache

È possibile cancellare il manifesto dell'applicazione incorporato e i dati memorizzati dal documento mediante uno dei metodi RemoveCustomization:

Per un documento aperto in un computer client, utilizzare il metodo Document.RemoveCustomization o Workbook.RemoveCustomization.
Per un documento chiuso o un documento in un server, utilizzare il metodo ServerDocument.RemoveCustomization.

Nota:
Mediante i metodi Document.RemoveCustomization e Workbook.RemoveCustomization viene inoltre rimosso dal documento il controllo Runtime Storage. Per ulteriori informazioni sul controllo Runtime Storage, vedere Cenni preliminari sul controllo Runtime Storage.

Per cancellare il manifesto dell'applicazione incorporato e i dati memorizzati da un documento aperto in un computer client

Nel progetto a livello di documento Microsoft Office Word o Microsoft Office Excel, chiamare il metodo Document.RemoveCustomization (per Word) o Workbook.RemoveCustomization (per Excel).

Per cancellare il manifesto dell'applicazione incorporato e i dati memorizzati da un documento chiuso o un documento in un server

Creare un nuovo progetto, ad esempio un'applicazione console o un progetto Windows Form.
Aggiungere un riferimento all'assembly Microsoft.VisualStudio.Tools.Applications.Runtime.dll nel progetto.

Aggiungere l'istruzione Imports o using seguente all'inizio del file di codice.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime

using Microsoft.VisualStudio.Tools.Applications.Runtime;

Chiamare il metodo statico RemoveCustomization della classe ServerDocument e specificare il percorso del documento della soluzione per il parametro.

If (ServerDocument.IsCustomized("C:\Documents\SolutionDocument.doc")) Then

    ServerDocument.RemoveCustomization("C:\Documents\SolutionDocument.doc")
End If

if (ServerDocument.IsCustomized(@"C:\Documents\SolutionDocument.doc"))
{
    ServerDocument.RemoveCustomization(@"C:\Documents\SolutionDocument.doc");
}