Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione

È necessario creare un set specifico di voci del Registro di sistema quando si distribuiscono i componenti aggiuntivi creati con Visual Studio 2010. Queste voci del Registro di sistema forniscono informazioni che consentono all'applicazione di Microsoft Office di individuare e caricare il componente aggiuntivo.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Microsoft Office 2010 e Microsoft Office System 2007. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Quando si compila il progetto, Visual Studio crea queste voci del Registro di sistema nel computer di sviluppo così da poter eseguire il componente aggiuntivo ed effettuarne il debug con facilità. Se si utilizza ClickOnce per implementare il componente aggiuntivo, le voci del Registro di sistema vengono create automaticamente nel computer dell'utente finale. Se si utilizza Windows Installer per distribuire il componente aggiuntivo, è necessario configurare il progetto di installazione per creare le voci del Registro di sistema nel computer dell'utente finale.

Per informazioni sulla modalità di utilizzo delle voci del Registro di sistema durante il processo di caricamento dei componenti aggiuntivi, vedere Architettura dei componenti aggiuntivi a livello di applicazione.

Nota

In questo argomento, il testo ID componente aggiuntivo rappresenta un ID univoco per il componente aggiuntivo. Per impostazione predefinita, l'ID è il nome dell'assembly componente aggiuntivo.

Registrazione dei componenti aggiuntivi per l'utente corrente rispetto aTutti gli utenti

Quando un componente aggiuntivo viene installato, può essere registrato in due modi:

• Solo per l'utente corrente (ovvero, è disponibile solo per l'utente che ha effettuato l'accesso al computer quando il componente aggiuntivo è installato). In questo caso, le voci del Registro di sistema vengono create sotto HKEY_CURRENT_USER.

• Per tutti gli utenti (ovvero qualsiasi utente che effettua l'accesso al computer e che può utilizzare il componente aggiuntivo). In questo caso, le voci del Registro di sistema vengono create sotto HKEY_LOCAL_MACHINE.

Tutti i componenti aggiunti creati utilizzando Visual Studio 2010 possono essere registrati per l'utente corrente. Tuttavia, i componenti aggiuntivi possono essere registrati per tutti gli utenti solo in determinati scenari. Questi scenari dipendono dalla versione di Microsoft Office nel computer e dal modo in cui il componente aggiuntivo è stato implementato.

Versione Microsoft Office

Per impostazione predefinita, le applicazioni del sistema Microsoft Office 2010 possono caricare solo i componenti aggiuntivi registrati in HKEY_LOCAL_MACHINE o HKEY_CURRENT_USER..

Per impostazione predefinita, le applicazioni del sistema Microsoft Office 2007 possono caricare solo i componenti aggiuntivi registrati in HKEY_CURRENT_USER. Per caricare i componenti aggiuntivi che vengono registrati in HKEY_LOCAL_MACHINE, nei computer in cui queste applicazioni sono installate devono essere installati anche i pacchetti relativi all'hotfix 976477. Per ulteriori informazioni, vedere il sito all'indirizzo https://go.microsoft.com/fwlink/?LinkId=184923 (informazioni in lingua inglese).

Tipo di distribuzione

Se si desidera utilizzare ClickOnce per distribuire un componente aggiuntivo, è possibile registrarlo solo per l'utente corrente. Ciò è dovuto al fatto che ClickOnce supporta solo la creazione di chiavi in HKEY_CURRENT_USER. Se si desidera registrare un componente aggiuntivo con tutti gli utenti di un computer, è necessario utilizzare Windows Installer per distribuire il componente aggiuntivo. Per ulteriori informazioni su questi tipi di distribuzione, vedere Pubblicazione di soluzioni Office e Distribuzione di una soluzione Office tramite Windows Installer.

Voci del Registro di sistema

Le voci del Registro di sistema del componente aggiuntivo richieste sono presenti sotto la seguente chiave del Registro di sistema seguente per tutte le applicazioni, eccetto Microsoft Office Visio, dove radice è HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE.

Root\Software\Microsoft\Office\nome applicazione\Addins\ID componente aggiuntivo

Per Visio, le voci del Registro di sistema sono sotto la seguente chiave del Registro di sistema.

Radice\Software\Microsoft\Visio\Addins\ID componente aggiuntivo

Nella tabella seguente sono elencate le voci presenti in questa chiave del Registro di sistema.

Voce	Digitare	Value
Description	REG_SZ	Obbligatoria. Breve descrizione del componente aggiuntivo. Questa descrizione è visualizzata quando l'utente seleziona il componente aggiuntivo nel riquadro Componenti aggiuntivi della finestra di dialogo Opzioni dell'applicazione di Microsoft Office.
FriendlyName	REG_SZ	Obbligatoria. Nome descrittivo del componente aggiuntivo visualizzato nella finestra di dialogo Componenti aggiuntivi COM dell'applicazione di Microsoft Office. Il valore predefinito è l'ID del componente aggiuntivo.
LoadBehavior	REG_DWORD	Obbligatoria. Valore che specifica quando l'applicazione tenta di caricare il componente aggiuntivo e lo stato corrente del componente aggiuntivo (caricato o scaricato). Per impostazione predefinita, questo valore è impostato su 3, a indicare che il componente aggiuntivo viene caricato all'avvio. Per ulteriori informazioni, vedere Valori di LoadBehavior.
Manifest	REG_SZ	Obbligatoria. Percorso completo del manifesto di distribuzione del componente aggiuntivo. Può essere un percorso contenuto nel computer locale, una condivisione di rete (UNC) o un server Web (HTTP). Se si utilizza Windows Installer per distribuire la soluzione, accodare la stringa |vstolocal (ovvero il carattere barra verticale |seguito da vstolocal) alla fine di questo percorso. In questo modo si garantisce che la soluzione venga caricata dalla cartella di installazione anziché dalla ClickOnce. Per ulteriori informazioni, vedere Distribuzione di una soluzione Office tramite Windows Installer. Nota Quando si compila un componente aggiuntivo nel computer di sviluppo, Visual Studio aggiunge automaticamente la stringa |vstolocal alla voce di registro.
Warmup	REG_DWORD	Facoltativo. Valore che indica che .NET Framework e Runtime di Visual Studio Tools per Office vengono caricati prima del caricamento del componente aggiuntivo e riducono il tempo percepito di caricamento del componente aggiuntivo. Impostare la voce Warmup su 1 e utilizzare questo insieme alla voce LoadBehavior per ridurre il tempo di caricamento per i componenti aggiuntivi di Outlook 2010 distribuiti tramite Windows Installer (estensione msi). Questa chiave del Registro di sistema non può essere impostata tramite ClickOnce.

Voci del Registro di sistema per le aree di modulo di Outlook

Se si crea un'area di modulo personalizzata in un componente aggiuntivo per Outlook, voci aggiuntive del Registro di sistema vengono utilizzate per registrare l'area di modulo in Outlook. Queste voci vengono create sotto una chiave del Registro di sistema diversa per ogni classe di messaggi che l'area del modulo supporta. Queste chiavi del Registro di sistema sono nel percorso seguente, dove Root è la chiave HKEY_CURRENT_USER o HKEY_LOCAL_MACHINE.

Root\Software\Microsoft\Office\Outlook\FormRegions\classe messaggio

Come le altre voci del Registro di sistema condivise da tutti i componenti aggiuntivi, Visual Studio crea queste voci del Registro di sistema della regione del form quando si compila il progetto. Se si utilizza ClickOnce per implementare il componente aggiuntivo, le voci del Registro di sistema vengono create automaticamente nel computer dell'utente finale. Se si utilizza Windows Installer per distribuire il componente aggiuntivo, è necessario configurare il progetto di installazione per creare le voci del Registro di sistema nel computer dell'utente finale.

Per ulteriori informazioni sulle voci del Registro di sistema dell'area di modulo, vedere Specifying Form Regions in Windows Registry (informazioni in lingua inglese). Per ulteriori informazioni sulle aree di modulo di Outlook, vedere Creazione di aree di modulo di Outlook.

Valori di LoadBehavior

La voce LoadBehavior sotto Directory radice\Software\Microsoft\Office\nome applicazione\Addins\ID componente aggiuntivo contiene una combinazione bit per bit di valori che specificano il comportamento in fase di esecuzione del componente aggiuntivo. Il bit dell'ordine più basso (valori 0 e 1) indica se il componente aggiuntivo attualmente è o non è caricato. Gli altri bit indicano quando l'applicazione tenta di caricare il componente aggiuntivo.

In genere, la voce LoadBehavior deve essere impostata su 0, 3 o 16 (in numero decimale) quando il componente aggiuntivo viene installato nei computer dell'utente finale. Per impostazione predefinita, Visual Studio imposta la voce LoadBehavior del componente aggiuntivo su 3 quando lo si compila o lo si pubblica.

Nella tabella riportata di seguito sono elencati tutti i possibili valori della voce LoadBehavior. Alcune descrizioni in questa tabella si riferiscono al caricamento manuale o a livello di codice di un componente aggiuntivo. Per caricare un componente aggiuntivo manualmente, selezionare la casella di controllo accanto al componente aggiuntivo nella finestra di dialogo Componenti aggiuntivi COM dell'applicazione. Per caricare un componente aggiuntivo a livello di codice, impostare la proprietà Connect dell'oggetto COMAddIn che rappresenta il componente aggiuntivo a true.

Valore decimale	Stato del componente aggiuntivo	Comportamento di caricamento del componente aggiuntivo.	Oggetto di descrizione
0	Unloaded	Non caricare automaticamente	L'applicazione non tenta mai di caricare il componente aggiuntivo automaticamente. L'utente può tentare di caricare manualmente il componente aggiuntivo o il componente aggiuntivo può essere caricato a livello di codice. Se il componente aggiuntivo è stato caricato correttamente, il valore LoadBehavior rimane 0, ma lo stato del componente aggiuntivo nella finestra di dialogo Componenti aggiuntivi COM viene aggiornato per indicare che il componente aggiuntivo è stato caricato.
1	Loaded	Non caricare automaticamente	L'applicazione non tenta mai di caricare il componente aggiuntivo automaticamente. L'utente può tentare di caricare manualmente il componente aggiuntivo o il componente aggiuntivo può essere caricato a livello di codice. Anche se la finestra di dialogo Componenti aggiuntivi COM indica che il componente aggiuntivo viene caricato dopo che si avvia l'applicazione, il componente aggiuntivo non viene effettivamente caricato finché non è stato caricato manualmente o a livello di codice. Se l'applicazione carica correttamente il componente aggiuntivo, il valore LoadBehavior diventa 0 e rimane 0 in seguito alla chiusura.
2	Unloaded	Carica all'avvio	L'applicazione non tenta di caricare il componente aggiuntivo automaticamente. L'utente può tentare di caricare manualmente il componente aggiuntivo o il componente aggiuntivo può essere caricato a livello di codice. Se l'applicazione carica correttamente il componente aggiuntivo, il valore LoadBehavior diventa 3 e rimane 3 in seguito alla chiusura.
3	Loaded	Carica all'avvio	L'applicazione tenta di caricare il componente aggiuntivo all'avvio dell'applicazione. Questo è il valore predefinito quando si compila o pubblica un componente aggiuntivo in Visual Studio. Se l'applicazione carica correttamente il componente aggiuntivo, il valore di LoadBehavior rimane 3. Se si verifica un errore durante il caricamento del componente aggiuntivo, il valore LoadBehavior diventa 2 e rimane 2 in seguito alla chiusura.
8	Unloaded	Carica su richiesta	L'applicazione non tenta di caricare il componente aggiuntivo automaticamente. L'utente può tentare di caricare manualmente il componente aggiuntivo o il componente aggiuntivo può essere caricato a livello di codice. Se l'applicazione carica correttamente il componente aggiuntivo, il valore di LoadBehavior viene impostato su 9.
9	Loaded	Carica su richiesta	Il componente aggiuntivo verrà caricato solo quando l'applicazione lo richiede, ad esempio quando un utente fa clic su un elemento dell'interfaccia utente che utilizza la funzionalità nel componente aggiuntivo (ad esempio, un pulsante personalizzato nella barra multifunzione). Se l'applicazione carica correttamente il componente aggiuntivo, il valore LoadBehavior rimane 9, ma lo stato del componente aggiuntivo nella finestra di dialogo Componenti aggiuntivi COM viene aggiornato per indicare che il componente aggiuntivo attualmente è stato caricato. Se si verifica un errore in caso di caricamento del componente aggiuntivo, il valore LoadBehavior diventa 8.
16	Loaded	Caricare la prima volta, quindi caricare su richiesta	Impostare questo valore se si desidera che il componente aggiuntivo venga caricato su richiesta. L'applicazione caricare il componente aggiuntivo quando l'utente esegue l'applicazione per la prima volta. La volta successiva che l'utente avvia l'applicazione, la stessa carica qualsiasi elemento dell'interfaccia utente definito dal componente aggiuntivo, ma il componente aggiuntivo non viene caricato finché l'utente non fa clic su un elemento dell'interfaccia utente associato al componente aggiuntivo. Quando l'applicazione carica correttamente il componente aggiuntivo per la prima volta, il valore LoadBehavior rimane 16 durante il caricamento del componente aggiuntivo. Dopo che l'applicazione si chiude, il valore LoadBehavior si modifica in 9.

Vedere anche

Concetti

Architettura dei componenti aggiuntivi a livello di applicazione

Cenni preliminari sul processo di compilazione delle soluzioni Office

Altre risorse

Architettura delle soluzioni Office in Visual Studio

Distribuzione di soluzioni Office

Cronologia delle modifiche

Data	Cronologia	Motivo
Maggio 2010	Fornito più contesto sull'utilizzo di |vstolocal nella voce del manifesto.	Miglioramento delle informazioni.