Cenni preliminari sul processo di generazione delle soluzioni Office
Aggiornamento: novembre 2007
La compilazione di una soluzione Microsoft Office è molto simile alla compilazione delle altre applicazioni in Visual Studio. Esistono tuttavia molti elementi da considerare che sono specifici delle soluzioni Office.
Per informazioni generali sulla compilazione di applicazioni, vedere Compilazione in Visual Studio.
Output del progetto per i progetti System 2007
Il percorso di output per un progetto System 2007 è nomeprogetto\bin\release o nomeprogetto\bin\debug. Non è possibile eseguire la generazione in una directory di distribuzione.
Progetti a livello di documento
Quando si compila un progetto a livello di documento, nell'output vengono inclusi gli elementi seguenti:
Una copia del documento del progetto.
L'assembly del progetto e tutti gli assembly a cui viene fatto riferimento la cui proprietà Copia localmente è impostata su true.
Il manifesto dell'applicazione, che ha l'estensione di file manifest. Per ulteriori informazioni, vedere Manifesti dell'applicazione per le soluzioni Office (System 2007).
Il manifesto della distribuzione, che ha l'estensione di file vsto. Per ulteriori informazioni, vedere Manifesti di distribuzione per le soluzioni Office (System 2007).
Un file di database di programma (PDB).
Progetti a livello di applicazione
Quando si genera un progetto a livello di applicazione, nell'output vengono inclusi gli elementi seguenti:
L'assembly del progetto e tutti gli assembly a cui viene fatto riferimento la cui proprietà Copia localmente è impostata su true.
Il manifesto dell'applicazione, che ha l'estensione di file manifest. Per ulteriori informazioni, vedere Manifesti dell'applicazione per le soluzioni Office (System 2007).
Il manifesto della distribuzione, che ha l'estensione di file vsto. Per ulteriori informazioni, vedere Manifesti di distribuzione per le soluzioni Office (System 2007).
Un file del database di programma (PDB) per l'assembly del progetto.
Il processo di generazione per i progetti a livello di applicazione crea inoltre un insieme di voci del Registro di sistema sul computer di sviluppo, necessario per il caricamento del componente aggiuntivo. Per ulteriori informazioni, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.
Se si compila un progetto per un componente aggiuntivo di Outlook che contiene aree del modulo, il processo di generazione aggiunge le informazioni aggiuntive seguenti al Registro di sistema:
Una chiave per ogni classe di messaggi associata a una o più aree del modulo.
Una voce per ogni area del modulo e un valore associato che rappresenta il nome del componente aggiuntivo di Outlook.
Outlook necessita di queste informazioni per caricare le aree del modulo.
Output del progetto per i progetti System 2003
Il percorso di output per un progetto System 2003 è nomeprogetto\bin\release o nomeprogetto\bin\debug. Non è possibile eseguire la generazione in una directory di distribuzione.
Progetti a livello di documento
Quando si compila un progetto a livello di documento, nell'output vengono inclusi gli elementi seguenti:
Una copia del documento del progetto.
L'assembly del progetto e tutti gli assembly a cui viene fatto riferimento la cui proprietà Copia localmente è impostata su true.
Il manifesto dell'applicazione (incorporato nel documento). Per ulteriori informazioni, vedere Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office.
Un file di database di programma (PDB).
Per le soluzioni Excel non è possibile modificare il percorso di output o la directory di lavoro. Impostando la directory di lavoro nel riquadro Debug di Progettazione progetti su un percorso diverso, all'apertura del documento Excel verrà ripristinata l'impostazione predefinita. Per le soluzioni Word invece, è possibile modificare il percorso di output in modo normale.
Progetti a livello di applicazione
Quando si genera un progetto a livello di applicazione, nell'output vengono inclusi gli elementi seguenti:
L'assembly del progetto e tutti gli assembly a cui viene fatto riferimento la cui proprietà Copia localmente è impostata su true.
Manifesto di applicazione. Per ulteriori informazioni, vedere Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office.
Un file di database di programma (PDB).
Il processo di generazione per i progetti a livello di applicazione crea inoltre un insieme di voci del Registro di sistema sul computer di sviluppo, necessario per il caricamento del componente aggiuntivo. Per ulteriori informazioni, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.
Assembly a cui viene fatto riferimento
È possibile fare riferimento agli assembly, inclusi i progetti Libreria di classi, dal progetto Visual Studio Tools per Office. Ogni assembly a cui viene fatto riferimento ha una proprietà chiamata Copia localmente. Copia localmente indica se l'assembly viene copiato o meno nella directory di output. Per impostazione predefinita la proprietà è impostata su true. Ogni assembly a cui viene fatto riferimento con la proprietà Copia localmente impostata su true viene copiato nella directory di output.
Sicurezza durante il processo di generazione
Visual Studio configura automaticamente le impostazioni di sicurezza nel computer di sviluppo per concedere l'attendibilità alla soluzione durante il processo di compilazione. Ciò consente alla soluzione di essere eseguita mentre se ne esegue il debug. La configurazione di sicurezza è gestita in modo diverso nei progetti per le varie versioni di Office.
Progetti per System 2007
Nei progetti per Microsoft Office System 2007, in Visual Studio Tools per Office vengono utilizzati un elenco di inclusione e i certificati per verificare l'editore. In Visual Studio viene creato automaticamente un certificato temporaneo per identificare le soluzioni Office e viene aggiunta una voce all'elenco di inclusione per considerare attendibile il certificato.
Per ulteriori informazioni, vedere Sicurezza nelle soluzioni Office (System 2007).
Progetti per System 2003
Per i progetti Microsoft Office 2003, Visual Studio Tools per Office include una proprietà booleana chiamata Percorso assembly attendibili. Questa proprietà viene visualizzata nella finestra Proprietà in Visual Studio. Per impostazione predefinita, questa proprietà è impostata su True. Se la proprietà è impostata su True, al momento della compilazione del progetto Visual Studio concede l'attendibilità totale all'assembly di progetto utilizzando l'URL come prova.
Autorizzazioni di attendibilità totale vengono anche concesse agli assembly di riferimento e satellite inclusi nella cartella di output. L'attendibilità è concessa a livello di utente per gli assembly che si trovano sul computer locale. Pertanto, non occorrono credenziali amministrative per tali progetti. Se si genera nuovamente il progetto in un percorso differente verranno rimosse le autorizzazioni di attendibilità totale per il percorso precedente. Per ulteriori informazioni sulla sicurezza, vedere Requisiti di sicurezza per l'esecuzione delle soluzioni Office (System 2003).
La verifica del percorso e la concessione dell'attendibilità a ogni compilazione consente di spostare e condividere i progetti senza dover modificare manualmente ogni volta la configurazione della sicurezza del computer. Tuttavia, per modificare il percorso del progetto è necessario utilizzare gli strumenti forniti da Visual Studio. Se si utilizza uno strumento esterno, ad esempio Esplora risorse, Visual Studio non è in grado di aggiornare le autorizzazioni.
Progetti di rete
Se il percorso dell'assembly o del documento si trova in una condivisione di rete, l'aggiornamento dei criteri di sicurezza locale (livello utente) non è sufficiente per consentire l'esecuzione della soluzione. Un amministratore dovrà infatti concedere agli assembly e ai documenti in una condivisione di rete l'attendibilità totale a livello di computer prima che la soluzione possa essere eseguita. Per ulteriori informazioni sull'impostazione dei criteri di sicurezza, vedere Procedura: concedere autorizzazioni a cartelle e assembly (System 2003).
Per i progetti a livello di documento per System 2007, è necessario aggiungere anche il percorso completo del documento all'elenco delle cartelle attendibili di Office. Per ulteriori informazioni, vedere Concessione dell'attendibilità ai documenti (2007 System).
Test di una personalizzazione a livello di documento
Premere F5 per generare una soluzione ed eseguirne il debug. Per testare una soluzione Word 2003 o Word 2007 senza eseguire il debug compilando e quindi aprendo il documento all'esterno di Visual Studio, chiudere il progetto prima di aprire il documento. Quando in Visual Studio viene aperto un documento di Word, viene impostato un flag sul processo di Word per impedire che vengano eseguite le personalizzazioni. Il flag può impedire l'esecuzione di personalizzazioni anche se si apre un documento personalizzato di Word all'esterno di Visual Studio facendo doppio clic sul file in Esplora risorse. Facendo doppio clic sul file, Word apre il documento nello stesso processo utilizzato da altri eventuali documenti in esecuzione. Poiché in Visual Studio è aperto un documento, quello nuovo verrà aperto nello stesso processo e riceverà il flag per non eseguire le personalizzazioni.
Test di un componente aggiuntivo a livello di applicazione
Premere F5 per generare una soluzione ed eseguirne il debug. Se si esegue il testing del componente aggiuntivo a livello di applicazione pubblicando e installando la soluzione, disinstallare la soluzione prima di pubblicarla di nuovo o di apportare ulteriori modifiche al codice ed eseguirne di nuovo il testing premendo F5. Quando si installa una soluzione pubblicata, l'assembly per il componente aggiuntivo viene installato nella cache ClickOnce. Il programma di installazione crea inoltre chiavi del Registro di sistema in modo che l'applicazione di Office possa trovare e caricare l'assembly. Poiché compilando nuovamente la soluzione si aggiornano le chiavi del Registro di sistema, è necessario disinstallare la prima versione prima di pubblicare o eseguire la seconda versione.
Utilizzo del comando Pulisci
Per rimuovere dal computer di sviluppo i file di progetto compilati, è possibile utilizzare il comando Pulisci dal menu Compilazione di Visual Studio. Il comando Pulisci elimina tutti i file intermedi presenti nel percorso dell'output di generazione. Per i progetti a livello di applicazione, il comando Pulisci consente inoltre di rimuovere le voci del Registro di sistema create dal processo di generazione.
.gif "Nota") Nota: |
|---|
Il comando Pulisci non rimuove le autorizzazioni concesse dal processo di generazione agli assembly di soluzione. Per ulteriori informazioni sulla rimozione delle autorizzazioni, vedere Procedura: rimuovere autorizzazioni da cartelle e assembly (System 2003). |
Modifica della piattaforma di destinazione in x64
Per impostazione predefinita, la piattaforma di destinazione è Qualunque CPU. Se si imposta la piattaforma di destinazione su x64, è possibile compilare il progetto ma la soluzione non verrà eseguita. La piattaforma di destinazione x64 richiede che la soluzione venga eseguita in un processo a 64 bit. Office viene eseguito in un processo a 32 bit. Pertanto, Office non sarà in grado di caricare la soluzione.
Vedere anche
Attività
Procedura: generare soluzioni Office
Concetti
Debug nei progetti a livello di documento