Procedura: aggiornare documenti di Office distribuiti in cui sono utilizzate estensioni di codice gestito (2003 System)

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.

Se a ciascun utente finale è stato distribuito un documento, un modello o una cartella di lavoro della soluzione e l'assembly della soluzione si trova in un percorso di rete, il documento non può essere facilmente aggiornato in modo automatico. È tuttavia possibile utilizzare le routine descritte in questo argomento per segnalare automaticamente agli utenti finali che il documento corrente di Office non è aggiornato e che è richiesta una versione più recente.

I passaggi fondamentali sono descritti di seguito:

Creare un nuovo progetto di applicazione Microsoft Office Word 2003 o Microsoft Office Excel 2003 basato sul documento che è stato aggiornato. L'assembly di questo progetto verrà utilizzato per notificare agli utenti che è necessario ottenere il documento aggiornato.
Spostare in un nuovo percorso l'assembly attualmente in uso e al suo posto collocare l'assembly con la notifica.
Associare il documento aggiornato al percorso dell'assembly del nuovo progetto.

Se non si desidera impedire agli utenti di utilizzare la soluzione obsoleta, è possibile chiamare la notifica tramite l'evento Startup della soluzione esistente, in modo da ricordare agli utenti di eseguire l'aggiornamento a ogni apertura del documento.

Per creare un nuovo progetto basato su un documento aggiornato

Apportare le modifiche necessarie a una copia del documento, del modello o della cartella di lavoro esistente.
In Visual Studio, creare un nuovo progetto di applicazione Word o Excel dello stesso tipo della soluzione esistente.

L'assembly di questo progetto verrà utilizzato come assembly di notifica e sostituirà l'assembly del progetto a cui fa riferimento il documento obsoleto di Office.
Scegliere Copia un documento esistente nella Creazione guidata progetto Visual Studio Tools per Office.
Fare clic su Sfoglia accanto alla casella di testo Percorso del documento esistente e passare al documento aggiornato.
Selezionare il documento e fare clic su Apri.
Scegliere Fine per creare il progetto basato sul documento aggiornato.

Per creare un assembly di notifica

Nel metodo Startup del nuovo assembly (ovvero l'assembly di notifica), aggiungere il codice per la visualizzazione di una finestra di messaggio contenente le informazioni necessarie all'utente per ottenere il documento aggiornato. Il codice che segue fornisce un esempio in proposito.

System.Windows.Forms.MessageBox.Show("This document has been updated. " _
    & "Please download a new version from the following location: " _
    & "\\ServerName\FolderName")

System.Windows.Forms.MessageBox.Show("This document has been updated. "
    + "Please download a new version from the following location: "
    + @"\\ServerName\FolderName");

Modificare il nome di output dell'assembly di notifica utilizzando le proprietà del progetto, in modo che tale nome corrisponda al nome dell'assembly di progetto utilizzato nella soluzione. Assicurarsi che l'assembly di notifica disponga delle caratteristiche necessarie (ad esempio un certificato appropriato) per poter essere considerato attendibile dalla soluzione distribuita.

Per sostituire l'assembly del progetto con l'assembly di notifica

Copiare in un nuovo percorso l'assembly del progetto utilizzato dalla soluzione e concedergli l'attendibilità nel nuovo percorso. Per ulteriori informazioni, vedere la classe Procedura: concedere autorizzazioni a cartelle e assembly (System 2003).
Inserire il documento aggiornato di Office nel nuovo percorso e copiarvi anche i manifesti di distribuzione e applicazione.
Modificare il nuovo manifesto dell'applicazione in modo che faccia riferimento al nuovo manifesto di distribuzione e al nuovo assembly. Per ulteriori informazioni, vedere la classe Manifesti dell'applicazione per le soluzioni Office (System 2003).
Aumentare il numero di versione del manifesto dell'applicazione.
Modificare il nuovo manifesto di distribuzione in modo che faccia riferimento al nuovo manifesto dell'applicazione. Per ulteriori informazioni, vedere la classe Manifesti di distribuzione per le soluzioni Office (System 2003).
Aumentare il numero di versione del nuovo manifesto di distribuzione.
Aggiornare il manifesto dell'applicazione incorporato nel documento affinché faccia riferimento al nuovo percorso del manifesto di distribuzione. Per ulteriori informazioni, vedere la classe Procedura: modificare il percorso del manifesto di distribuzione a livello di codice (System 2003).

Non appena sarà comunicato gli utenti finali il percorso del documento aggiornato, sarà possibile utilizzare il documento aggiornato e l'assembly a cui fa riferimento.
Distribuire l'assembly di notifica nel percorso dell'assembly precedente e rimuovere l'assembly del progetto. Alla successiva apertura del documento di Office obsoleto, il sistema eseguirà l'assembly di notifica e visualizzerà la finestra di messaggio contenente le informazioni su come ottenere la versione aggiornata del documento.