Condividi tramite

Voci del Registro di sistema per i componenti aggiuntivi VSTO

  • Articolo

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

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti di componente aggiuntivo VSTO. Per altre informazioni, 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.

Quando si compila il progetto, Visual Studio crea queste voci del Registro di sistema nel computer di sviluppo. In questo modo è possibile eseguire ed eseguire facilmente il debug del componente aggiuntivo VSTO. Usando ClickOnce per distribuire il componente aggiuntivo VSTO, le voci del Registro di sistema vengono create automaticamente nel computer dell'utente finale.

Per altre informazioni su come distribuire una soluzione VSTO con Windows Installer, vedere Distribuzione di una soluzione VSTO con Windows Installer.

Per altre informazioni sull'uso delle voci del Registro di sistema durante il processo di caricamento per i componenti aggiuntivi VSTO, vedere Architecture of VSTO Add-ins.

Nota

In questo argomento la dicitura ID componente aggiuntivo rappresenta l'identificatore univoco del componente aggiuntivo VSTO. Per impostazione predefinita, l'ID è il nome dell'assembly del componente aggiuntivo VSTO.

Registrare i componenti aggiuntivi VSTO per l'utente corrente e tutti gli utenti

Un componente aggiuntivo VSTO installato può essere registrato in due modi diversi:

  • Solo per l'utente corrente (il componente aggiuntivo VSTO è disponibile solo per l'utente connesso al computer quando è stato installato il componente aggiuntivo). In questo caso, le voci del Registro di sistema vengono create nel HKEY_CURRENT_Uedizione Standard R.

  • Per tutti gli utenti, ovvero qualsiasi utente che accede al computer può usare il componente aggiuntivo VSTO. In questo caso, le voci del Registro di sistema vengono create in HKEY_LOCAL_MACHINE.

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

Tipo di distribuzione

Se si usa ClickOnce per distribuire un componente aggiuntivo VSTO, quest'ultimo può essere registrato solo per l'utente corrente. Questo perché ClickOnce supporta solo la creazione di chiavi in HKEY_CURRENT_Uedizione Standard R. Se si vuole registrare un componente aggiuntivo VSTO per tutti gli utenti di un computer, è necessario distribuirlo tramite Windows Installer. Per altre informazioni su questi tipi di distribuzione, vedere Distribuire una soluzione Office usando ClickOnce e Distribuire una soluzione Office tramite Windows Installer.

Voci del Registro di sistema

Le voci del Registro di sistema del componente aggiuntivo VSTO necessarie si trovano nelle chiavi del Registro di sistema seguenti in cui Root è HKEY_CURRENT_Uedizione Standard R o HKEY_LOCAL_MACHINE a seconda che l'installazione sia per l'utente corrente o per tutti gli utenti.

Applicazione di Office Percorso di configurazione
Visio Root\Software\Microsoft\Visio\Addins\add-in ID
Tutti gli altri Root\Software\Microsoft\Office\app Office lication name\Addins\add-in ID

Nota

Se il programma di installazione è destinato a tutti gli utenti in Windows a 64 bit, è consigliabile includere due voci del Registro di sistema, una nella HKEY_LOCAL_MACHINE\Software\Microsoft e una sotto l'hive HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft. Ciò è dovuto al fatto che gli utenti possono usare versioni a 32 bit o a 64 bit di Office nel computer.

Se il programma di installazione è destinato all'utente corrente, non deve essere installato in WOW6432Node perché il percorso HKEY_CURRENT_Uedizione Standard R\Software è condiviso.

Per altre informazioni, vedere Dati dell'applicazione a 32 bit e a 64 bit nel Registro di sistema.

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

Movimento Type Valore
Descrizione REG_SZ Obbligatorio. Breve descrizione del componente aggiuntivo VSTO.

Questa descrizione viene visualizzata quando l'utente seleziona il componente aggiuntivo VSTO nel riquadro Componenti aggiuntivi della finestra di dialogo Opzioni nell'applicazione di Microsoft Office.
FriendlyName REG_SZ Obbligatorio. Nome descrittivo del componente aggiuntivo VSTO visualizzato nella finestra di dialogo Componenti aggiuntivi COM dell'applicazione di Microsoft Office. Il valore predefinito è l'ID del componente aggiuntivo VSTO.
LoadBehavior REG_DWORD Obbligatorio. Valore che specifica quando l'applicazione tenta di caricare il componente aggiuntivo VSTO e lo stato corrente del componente aggiuntivo VSTO (caricato o scaricato).

Per impostazione predefinita, questo valore è impostato su 3, a indicare che il componente aggiuntivo VSTO viene caricato all'avvio. Per altre informazioni, vedere Valori di LoadBehavior.

Nota: se un utente disabilita il componente aggiuntivo VSTO, tale azione modifica il valore loadBehavior nell'hive del Registro di sistema HKEY_CURRENT_Uedizione Standard R. Per ogni utente, il valore del valore loadBehavior nell'hive HKEY_CURRENT_Uedizione Standard R esegue l'override del loadBehavior predefinito definito nell'hive HKEY_LOCAL_MACHINE.
Manifesto REG_SZ Obbligatorio. Percorso completo del manifesto della distribuzione del componente aggiuntivo VSTO. Può essere un percorso contenuto nel computer locale, una condivisione di rete (UNC) o un server Web (HTTP).

Se si usa Windows Installer per distribuire la soluzione, è necessario aggiungere il prefisso file:/// al percorso di manifesto . È inoltre necessario aggiungere la stringa |vstolocal ( ovvero il carattere | pipe seguito da vstolocal) alla fine di questo percorso. Il suffisso garantisce che la soluzione venga caricata dalla cartella di installazione e non dalla cache ClickOnce. Per altre informazioni, vedere Distribuire una soluzione Office con Windows Installer.

Nota: quando si compila un componente aggiuntivo VSTO nel computer di sviluppo, Visual Studio aggiunge automaticamente la stringa |vstolocal a questa voce del Registro di sistema.

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

Se si crea un'area del modulo personalizzata in un componente aggiuntivo VSTO per Outlook, vengono usate voci aggiuntive del Registro di sistema per registrare l'area con Outlook. Queste voci vengono create in una chiave del Registro di sistema diversa per ogni classe di messaggio supportata dall'area. Queste chiavi del Registro di sistema si trovano nel percorso seguente, dove Root è HKEY_CURRENT_Uedizione Standard R o HKEY_LOCAL_MACHINE.

Root\Software\Microsoft\Office\Outlook\FormRegions\message class

Analogamente alle altre voci del Registro di sistema condivise da tutti i componenti aggiuntivi VSTO, Visual Studio crea le voci relative all'area del modulo nel computer di sviluppo durante la compilazione del progetto. Usando ClickOnce per distribuire il componente aggiuntivo VSTO, le voci del Registro di sistema vengono create automaticamente nel computer dell'utente finale. Quando si usa Windows Installer per distribuire il componente aggiuntivo VSTO, è necessario configurare il progetto InstallShield Limited Edition per creare le voci del Registro di sistema nel computer dell'utente finale.

Per altre informazioni sulle voci del Registro di sistema dell'area del modulo, vedere Specificare la posizione di un'area del modulo in un modulo personalizzato. Per altre informazioni sulle aree del modulo di Outlook, vedere Creare aree del modulo di Outlook.

Valori di LoadBehavior

La voce LoadBehavior in Root\Software\Microsoft\Office\application name\Addins\add-in ID contiene una combinazione bit per bit di valori che specificano il comportamento di runtime del componente aggiuntivo VSTO. Il bit di ordine più basso (valori 0 e 1) indica se il componente aggiuntivo VSTO è attualmente caricato o scaricato. Gli altri bit indicano quando l'applicazione tenta di caricare il componente aggiuntivo VSTO.

In genere, la voce LoadBehavior deve essere impostata su 0, 3 o 16 (in decimale) quando il componente aggiuntivo VSTO è installato nei computer degli utenti finali. Per impostazione predefinita, Visual Studio imposta la voce LoadBehavior del componente aggiuntivo VSTO su 3 quando questo viene compilato o pubblicato.

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

Valore decimale Stato del componente aggiuntivo VSTO Comportamento di caricamento del componente aggiuntivo VSTO Descrizione
0 Unloaded Non caricare automaticamente L'applicazione non tenta mai di caricare il componente aggiuntivo VSTO automaticamente. L'utente può provare a caricare manualmente il componente aggiuntivo VSTO oppure quest'ultimo può essere caricato a livello di codice.

Se il componente aggiuntivo VSTO viene caricato correttamente, il valore di LoadBehavior rimane impostato su 0, ma lo stato del componente aggiuntivo VSTO nella finestra di dialogo Componenti aggiuntivi COM viene aggiornato per indicare che il componente aggiuntivo VSTO è caricato.
1 Loaded Non caricare automaticamente L'applicazione non tenta mai di caricare il componente aggiuntivo VSTO automaticamente. L'utente può provare a caricare manualmente il componente aggiuntivo VSTO oppure quest'ultimo può essere caricato a livello di codice.

Anche se la finestra di dialogo Componenti aggiuntivi COM indica che il componente aggiuntivo VSTO viene caricato dopo l'avvio dell'applicazione, il componente aggiuntivo VSTO non viene caricato fino a quando non viene caricato manualmente o a livello di codice.

Se l'applicazione carica correttamente il componente aggiuntivo VSTO, il valore di LoadBehavior diventa 0 e rimane tale dopo la chiusura dell'applicazione.
2 Unloaded Viene caricato all'avvio L'applicazione non tenta di caricare automaticamente il componente aggiuntivo VSTO. L'utente può provare a caricare manualmente il componente aggiuntivo VSTO oppure quest'ultimo può essere caricato a livello di codice.

Se l'applicazione carica correttamente il componente aggiuntivo VSTO, il valore di LoadBehavior diventa 3 e rimane tale dopo la chiusura dell'applicazione.
3 Loaded Viene caricato all'avvio L'applicazione tenta di caricare il componente aggiuntivo VSTO all'avvio. Questo è il valore predefinito quando si compila o si pubblica un componente aggiuntivo VSTO in Visual Studio.

Se l'applicazione carica correttamente il componente aggiuntivo VSTO, il valore di LoadBehavior rimane impostato su 3. Se si verifica un errore durante il caricamento del componente aggiuntivo VSTO, il valore di LoadBehavior diventa 2 e rimane tale dopo la chiusura dell'applicazione.
8 Unloaded Viene caricato su richiesta L'applicazione non tenta di caricare automaticamente il componente aggiuntivo VSTO. L'utente può provare a caricare manualmente il componente aggiuntivo VSTO oppure quest'ultimo può essere caricato a livello di codice.

Se l'applicazione carica correttamente il componente aggiuntivo VSTO, il valore di LoadBehavior diventa 9.
9 Loaded Viene caricato su richiesta Il componente aggiuntivo VSTO verrà caricato solo quando l'applicazione lo richiede. Ad esempio quando un utente seleziona un elemento dell'interfaccia utente che usa la funzionalità nel componente aggiuntivo VSTO (ad esempio, un pulsante personalizzato nella barra multifunzione).

Se l'applicazione carica correttamente il componente aggiuntivo VSTO, il valore di LoadBehavior rimane impostato su 9, ma lo stato del componente aggiuntivo VSTO nella finestra di dialogo Componenti aggiuntivi COM viene aggiornato per indicare che il componente aggiuntivo VSTO è attualmente caricato. Se si verifica un errore durante il caricamento del componente aggiuntivo VSTO, il valore di LoadBehavior diventa 8.
16 Loaded Viene caricato la prima volta e successivamente su richiesta Impostare questo valore se si vuole che il componente aggiuntivo VSTO venga caricato su richiesta. L'applicazione carica il componente aggiuntivo VSTO quando viene eseguita dall'utente per la prima volta. Al successivo esecuzione dell'applicazione, l'applicazione carica tutti gli elementi dell'interfaccia utente definiti dal componente aggiuntivo VSTO. Tuttavia, il componente aggiuntivo VSTO non viene caricato finché l'utente non seleziona un elemento dell'interfaccia utente associato al componente aggiuntivo VSTO.

Quando l'applicazione carica correttamente il componente aggiuntivo VSTO per la prima volta, il valore di LoadBehavior rimane impostato su 16 mentre il componente aggiuntivo VSTO è caricato. Dopo la chiusura dell'applicazione, il valore di LoadBehavior viene impostato su 9.

Contenuto correlato