Procedura dettagliata: distribuzione di un documento e di un assembly in una cartella locale (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.

In questa procedura dettagliata viene illustrato come distribuire una personalizzazione a livello di documento in una nuova cartella del computer di sviluppo in modo che il documento e l'assembly siano contenuti nella stessa cartella. Questo tipo di distribuzione è noto come modello di distribuzione locale/locale.

Per ulteriori informazioni sui diversi modi in cui è possibile distribuire una soluzione, vedere Modelli di distribuzione (2003 System). Per ulteriori informazioni sulle personalizzazioni a livello di documento, vedere Architettura delle personalizzazioni a livello di documento.

In questa procedura dettagliata vengono illustrate le attività seguenti:

Concessione dell'attendibilità totale a un assembly di una soluzione Visual Studio Tools per Office contenuto in una cartella locale.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei seguenti componenti:

Visual Studio Tools per Office°(componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).

Microsoft Office Word 2003 o Microsoft Office Excel 2003.

Nota:
In questa procedura dettagliata si presuppone che venga distribuita una soluzione Word. Se si desidera eseguire la procedura dettagliata con una soluzione Excel, sostituire il nome del progetto Word con il nome del progetto Excel in tutti gli esempi di codice.

Privilegi di amministratore nel computer di sviluppo in modo da poter impostare i criteri di sicurezza.

Creazione di una soluzione da distribuire

Come primo passaggio, creare una soluzione Visual Studio Tools per Office di base da distribuire. Se si dispone già di una soluzione da distribuire, è possibile ignorare questa sezione e procedere a "Distribuzione della soluzione".

Per creare una soluzione da distribuire

Creare un progetto Documento di Word con il nome WordDeployment, utilizzando il modello di progetto per Office 2003.

Nella procedura guidata, scegliere Crea un nuovo documento. Per ulteriori informazioni, vedere la classe Procedura: creare progetti Visual Studio Tools per Office.
In Esplora soluzioni fare clic con il pulsante destro del mouse sul file di codice ThisDocument, quindi scegliere Visualizza codice.
Aggiungere il codice seguente al gestore eventi ThisDocument_Startup. Mediante questo codice viene visualizzato un messaggio all'apertura del documento. Tale evento consente di verificare agevolmente se la soluzione è stata distribuita in modo corretto.
```
MessageBox.Show("The deployment is successful")
```
```
MessageBox.Show("The deployment is successful");
```
Per ulteriori informazioni sull'evento Startup, vedere Eventi di progetti Visual Studio Tools per Office.
Premere F5 per compilare ed eseguire il progetto. Verificare che il messaggio venga visualizzato.

Distribuzione della soluzione

Ora è possibile distribuire il documento e l'assembly in una nuova cartella del computer di sviluppo.

Per distribuire la soluzione

Creare una cartella denominata TestDeploy nella radice dell'unità di sistema di Windows (%SystemDrive%). Se ad esempio l'unità di sistema è C, la directory sarà C:\TestDeploy.
Copiare il documento e l'assembly dalla cartella dell'output di compilazione, generalmente cartella progetto\bin\debug o cartella progetto\bin\release) alla cartella %SystemDrive%\TestDeploy.
Aprire il documento nella cartella %SystemDrive%\TestDeploy. Un messaggio di errore segnalerà che il criterio di sicurezza .NET corrente non consente l'esecuzione della personalizzazione. L'errore è causato dal fatto che non si è ancora concessa l'attendibilità totale all'assembly.
Scegliere OK, quindi chiudere il documento.

Impostazione dei criteri di sicurezza

Prima di eseguire la soluzione, è necessario concedere l'attendibilità totale all'assembly nei criteri di sicurezza di .NET Framework 2.0. Viene utilizzato lo strumento Criteri di sicurezza dall'accesso di codice (Caspol.exe) per concedere l'attendibilità totale all'assembly.

Per ulteriori informazioni sull'utilizzo di Caspol.exe, vedere Strumento criteri di protezione dall'accesso di codice (Caspol.exe) e Configurazione dei criteri di protezione tramite lo Strumento criteri di protezione dall'accesso di codice (Caspol.exe).

Nota sulla sicurezza:
In questo contesto viene illustrata la procedura di base per impostare criteri di sicurezza basati sull'evidenza dell'URL. Utilizzare questa procedura per concedere l'attendibilità ad assembly di soluzioni reali solo se si è certi che il percorso sia sicuro e protetto. È inoltre consigliabile basare la sicurezza di una soluzione reale su un'evidenza più efficace dell'URL dell'assembly. Per ulteriori informazioni, vedere la classe Requisiti di sicurezza per l'esecuzione delle soluzioni Office (System 2003).

In questo contesto viene illustrata la procedura di base per impostare criteri di sicurezza basati sull'evidenza dell'URL. Utilizzare questa procedura per concedere l'attendibilità ad assembly di soluzioni reali solo se si è certi che il percorso sia sicuro e protetto. È inoltre consigliabile basare la sicurezza di una soluzione reale su un'evidenza più efficace dell'URL dell'assembly. Per ulteriori informazioni, vedere la classe Requisiti di sicurezza per l'esecuzione delle soluzioni Office (System 2003).

Per concedere l'attendibilità totale all'assembly

Al prompt dei comandi, digitare il comando seguente per creare un nuovo gruppo di codice in grado di concedere l'attendibilità totale all'assembly. Sostituire full assembly path con il percorso completo dell'assembly nel computer di sviluppo, ad esempio C:\TestDeploy\WordDeployment.dll.
```
%windir%\Microsoft.NET\Framework\v2.0.50727\caspol -u -ag All_Code -url "full assembly path" FullTrust -n "Test_Deployment"
```
Mediante il parametro -n viene specificato un nome per il nuovo gruppo di codice. Tale parametro non è obbligatorio, ma definendo un'etichetta sarà più facile, in seguito, individuare e rimuovere il nuovo codice di gruppo, una volta completata questa procedura dettagliata.
Digitare yes quando richiesto per confermare che si desidera eseguire l'operazione, quindi premere INVIO.
Aprire il documento nella cartella %SystemDrive%\TestDeploy e verificare che venga visualizzato il messaggio.
Scegliere OK, quindi chiudere il documento.

Passaggi successivi

È anche possibile distribuire il documento e l'assembly in cartelle differenti dello stesso computer oppure in una cartella di rete. Per ulteriori informazioni, vedere le seguenti procedure dettagliate: