Progettare e creare soluzioni Office

  • Articolo

Visual Studio fornisce modelli di progetto che è possibile utilizzare per creare diversi tipi di soluzioni Office. In questa sezione della documentazione vengono descritti i modelli di progetto e vengono fornite informazioni aggiuntive sulla creazione di progetti di Office. Per informazioni su come implementare personalizzazioni del codice e dell'interfaccia utente dopo aver creato il progetto, vedere Sviluppare soluzioni Office.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO. Vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Nota

Si è interessati allo sviluppo di soluzioni che estendono l'esperienza di Office tra più piattaforme? Vedere il nuovo modello di componenti aggiuntivi per Office. I componenti aggiuntivi di Office hanno un footprint ridotto rispetto ai componenti aggiuntivi e alle soluzioni VSTO ed è possibile compilarli usando quasi qualsiasi tecnologia di programmazione Web, ad esempio HTML5, JavaScript, CSS3 e XML.

Creare progetti di Office

Prima di iniziare, è necessario stabilire i requisiti e individuare il tipo di soluzione più adatta alle proprie esigenze. Ad esempio, se la soluzione Office deve essere eseguita ogni volta che viene usata l'applicazione, un componente aggiuntivo VSTO è più adatto per soddisfare le esigenze. Se il codice è strettamente integrato con un unico documento, creare una personalizzazione a livello di documento. Questi tipi di progetto sono disponibili come modelli di progetto Visual Studio. Per altre informazioni sui modelli di progetto di Office inclusi in Visual Studio, vedere Panoramica dei modelli di progetto di Office. Per altre informazioni su come creare progetti di Office, vedere Procedura: Creare progetti di Office in Visual Studio.

I progetti Office presentano funzionalità ed elementi di progetto diversi da altri tipi di progetti in Visual Studio. Ad esempio, quando si crea un progetto a livello di documento, il documento o cartella di lavoro nel progetto può essere aperto e modificato in Visual Studio. Per altre informazioni, vedere Progetti di Office nell'ambiente Visual Studio.

Scegliere una versione di .NET Framework

Dopo aver selezionato il tipo di progetto che meglio soddisfa le proprie esigenze, è possibile scegliere quale versione di .NET Framework utilizzare nel processo di sviluppo. È possibile destinare le seguenti versioni di .NET Framework nei progetti di Office:

  • .NET Framework 4

  • .NET Framework 4 Client Profile

  • .NET Framework 4.5

    La versione di .NET Framework scelta per il progetto è necessaria nei computer degli utenti finali per l'esecuzione della soluzione. Ad esempio, se il progetto è destinato a .NET Framework 4, .NET Framework 4 è necessario nei computer degli utenti finali. In questo esempio la soluzione non verrà eseguita se solo .NET Framework 3.5 è installato nei computer degli utenti finali.

    Se si esegue la migrazione di un progetto di componente aggiuntivo VSTO destinato a .NET Framework 3.5, Visual Studio modifica il framework di destinazione del progetto in .NET Framework 4 o versione successiva a seconda della versione di Office installata.

    Dopo la modifica del framework di destinazione, tuttavia, potrebbe essere necessario modificare parte del codice nel progetto se vengono utilizzate alcune funzionalità. Per altre informazioni su come modificare il framework di destinazione, vedere Procedura: Impostare come destinazione una versione di .NET Framework. Per altre informazioni sulle modifiche che potrebbe essere necessario apportare nel progetto, vedere Eseguire la migrazione di soluzioni Office a .NET Framework 4 o versione successiva.

    Se Visual Studio modifica .NET Framework di destinazione per il progetto e si usa ClickOnce per distribuire la soluzione, assicurarsi di selezionare anche la versione corrispondente di .NET Framework nella finestra di dialogo Prerequisiti . Questa selezione non viene modificata automaticamente quando si modifica il framework di destinazione per il progetto. Per altre informazioni, vedere Procedura: Installare i prerequisiti nei computer degli utenti finali per eseguire soluzioni Office.

Nota

Non è possibile usare .NET Framework 3.5 o versioni precedenti nei progetti di Office creati usando Visual Studio 2013. I progetti di Office creati con Visual Studio 2013 richiedono funzionalità introdotte per la prima volta nel profilo client di .NET Framework 4

Comprendere quando i piA di Office sono necessari nei computer degli utenti finali

Per impostazione predefinita, non è necessario installare assembly di interoperabilità primari di Office nei computer degli utenti finali se la proprietà Incorpora tipi di interoperabilità di ogni riferimento pia di Office nel progetto è impostata su True, ovvero il valore predefinito. In questo scenario, le informazioni sul tipo per i tipi di assembly di interoperabilità primari utilizzati dalla soluzione vengono incorporate nell'assembly della soluzione quando si compila il progetto. In fase di esecuzione, le informazioni sul tipo incorporato vengono usate invece dei PIA per chiamare nel modello a oggetti basato su COM di app Office lication. Per altre informazioni sul modo in cui i tipi di informazioni personali vengono incorporati nella soluzione, vedere Equivalenza dei tipi e tipi di interoperabilità incorporati.

Se la proprietà Incorpora tipi di interoperabilità di ogni riferimento pia di Office nel progetto è impostata su False, i piA di Office devono essere installati e registrati nella Global Assembly Cache in ogni computer dell'utente finale che esegue la soluzione. Nella maggior parte dei casi, gli assembly di interoperabilità primari vengono installati per impostazione predefinita con Office, ma è anche possibile includere l'assembly di interoperabilità primario ridistribuibile come prerequisito per la soluzione. Per altre informazioni, vedere Prerequisiti della soluzione Office per la distribuzione.

Informazioni sul profilo client

.NET Framework Client Profile è un sottoinsieme della versione completa di .NET Framework. È possibile scegliere .NET Framework Client Profile se è necessario utilizzare solo le funzionalità client di .NET Framework e si desidera fornire l'esperienza di distribuzione più veloce per la soluzione Office. Per altre informazioni, vedere Profilo client .NET Framework.

Quando si crea un progetto di Office destinato a .NET Framework 4, il profilo client .NET Framework 4 è destinato per impostazione predefinita. Se si vuole sviluppare per la versione completa di .NET Framework 4, è necessario impostare questa opzione dopo la creazione del progetto. Per altre informazioni, vedere Procedura: Scegliere una versione di .NET Framework.

Creare soluzioni per l'edizione a 64 bit di Microsoft Office

Microsoft Office è disponibile nelle edizioni a 64 bit e a 32 bit. Per creare soluzioni Office eseguibili in entrambe le edizioni, l'impostazione di destinazione della piattaforma per il progetto deve essere impostata su Qualsiasi CPU. Questo è il valore predefinito per i progetti Office. Per altre informazioni, vedere Creare soluzioni Office.

Sono disponibili versioni separate a 64 bit e a 32 bit del runtime di Strumenti di Visual Studio per Office usate dalle edizioni a 64 bit e a 32 bit di Microsoft Office. Per altre informazioni, vedere Strumenti di Visual Studio per la panoramica del runtime di Office.

Assembly nelle soluzioni Office

Quando si crea un progetto di Office mediante gli strumenti di sviluppo per Office in Visual Studio, il codice scritto viene compilato in un assembly. L'assembly viene distribuito in un server condiviso o in una directory nel computer client.

Gli assembly nelle soluzioni Office vengono caricati da un'applicazione di Office. Dopo che l'assembly viene caricato, il codice nell’assembly può rispondere agli eventi generati nell'applicazione (ad esempio quando un utente fa clic su una voce di menu). Il codice nell'assembly può anche chiamare nel modello a oggetti per automatizzare ed estendere l'applicazione e può usare una qualsiasi delle classi in .NET Framework. Per altre informazioni, vedere Architettura delle personalizzazioni a livello di documento e Architettura dei componenti aggiuntivi VSTO.

Le soluzioni Office utilizzano i manifesti di distribuzione e di applicazione per identificare l'assembly. I manifesti contengono informazioni su nome, versione e percorso dell'assembly, per cui l'applicazione può trovare, collegare ed eseguire l'assembly corretto. Per altre informazioni, vedere Manifesti dell'applicazione e della distribuzione nelle soluzioni Office.

I progetti a livello di documento includono un documento oltre a un assembly. Il documento agisce come front-end dell'applicazione ed è il luogo in cui avviene l'interazione dell’utente. Ogni documento può avere un solo assembly principale del progetto associato. Tuttavia, più documenti possono puntare allo stesso assembly.

Gli assembly nei progetti a livello di documento non sono incorporati nel documento, ma vengono archiviati in una posizione diversa e sono identificati dal manifesto di applicazione del documento.

Considerazioni sulla sicurezza per gli assembly

Perché una soluzione Office venga eseguita in un computer, gli assembly utilizzati dalla soluzione devono essere attendibili per l'esecuzione. Per altre informazioni sulla sicurezza, vedere Proteggere le soluzioni Office.

Per impostazione predefinita, l'assembly della soluzione e tutti gli assembly di riferimento che si trovano nella cartella di output del progetto sono attendibili per l'esecuzione nel computer di sviluppo quando si compila il progetto. Per altre informazioni, vedere Creare soluzioni Office.

Per motivi di sicurezza, è consigliabile creare progetti nel computer locale anziché svilupparli in un percorso condiviso. Per altre informazioni, vedere Sviluppo collaborativo di soluzioni Office.

Assembly di riferimento

L'assembly può fare riferimento ad altri assembly elencati nei riferimenti del progetto. Tuttavia, un assembly del progetto a livello di documento non può fare riferimento a un altro assembly del progetto a livello di documento.

Contenuto correlato