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

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 applicazione Versione Microsoft Office Microsoft Office System 2007 Microsoft Office 2003 Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione.

È necessario creare un insieme specifico di voci del Registro di sistema quando si distribuiscono i componenti aggiuntivi creati con Visual Studio Tools per Office. Queste voci del Registro di sistema forniscono informazioni che consentono all'applicazione di Microsoft Office di individuare e caricare il componente aggiuntivo. Per ulteriori informazioni, vedere Architettura dei componenti aggiuntivi a livello di applicazione.

Quando si compila il progetto, Visual Studio Tools per Office crea queste voci del Registro di sistema nel computer di sviluppo così da poter eseguire facilmente il debug del componente aggiuntivo. Per ulteriori informazioni, vedere Cenni preliminari sul processo di generazione delle soluzioni Office.

Per informazioni sulla creazione delle chiavi del Registro di sistema nei computer dell'utente finale quando si distribuisce il componente aggiuntivo, vedere Distribuzione di soluzioni Office (2007 System) e Distribuzione di componenti aggiuntivi a livello di applicazione (System 2003).

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

Voci del Registro di sistema per Microsoft Office System 2007

Le voci del Registro di sistema del componente aggiuntivo richieste per Microsoft Office System 2007 sono presenti sotto la seguente chiave del Registro di sistema per tutte le applicazioni, eccetto Microsoft Office Visio:

HKEY_CURRENT_USER\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:

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

Nota:
Le applicazioni di Microsoft Office System 2007 riconoscono solo i componenti aggiuntivi Visual Studio Tools per Office registrati sotto HKEY_CURRENT_USER. Di conseguenza, non è possibile distribuire un componente aggiuntivo Visual Studio Tools per Office per Microsoft Office System 2007 a tutti gli utenti in un computer registrando il componente aggiuntivo sotto HKEY_LOCAL_MACHINE.

Nella tabella seguente sono elencate le voci richieste sotto questa chiave del Registro di sistema.

Voce	Tipo	Valore
Description	REG_SZ	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	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	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	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). Nota: Quando si compila un componente aggiuntivo nel computer di sviluppo, Visual Studio Tools per Office aggiunge la stringa | vstolocal (ovvero, il carattere barra verticale | seguito da vstolocal) a questa voce del Registro di sistema. In tal modo Visual Studio Tools per Office potrà caricare il componente aggiuntivo quando lo si esegue da Visual Studio nel computer di sviluppo.

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 Microsoft Office Outlook 2007, una voce del Registro di sistema viene utilizzata per registrare l'area di modulo in Outlook. Questa voce del Registro di sistema si trova sotto la chiave seguente:

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

Per ulteriori informazioni, vedere Specifying Form Regions in the Windows Registry (informazioni in lingua inglese). Per ulteriori informazioni sulle aree di modulo di Outlook, vedere Creazione di aree di modulo di Outlook.

Voci del Registro di sistema per Microsoft Office 2003

Le voci del Registro di sistema del componente aggiuntivo richieste per Microsoft Office 2003 sono presenti sotto le seguenti chiavi del Registro di sistema:

• HKEY_CURRENT_USER\Software\Microsoft\Office\nome applicazione\Addins\ID componente aggiuntivo

• HKEY_CURRENT_USER\Software\Classes\ID componente aggiuntivo\CLSID

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID componente aggiuntivo}

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID componente aggiuntivo}\InprocServer32

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID componente aggiuntivo}\ProgID

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID componente aggiuntivo}\Programmable

• HKEY_CURRENT_USER\Software\Classes\CLSID\{CLSID componente aggiuntivo}\VersionIndependentProgID

Nota:
È possibile rendere disponibile un componente aggiuntivo Visual Studio Tools per Office per Microsoft Office 2003 a tutti gli utenti in un computer creando le chiavi del Registro di sistema sotto HKEY_LOCAL_MACHINE anziché HKEY_CURRENT_USER.

Nelle seguenti sezioni sono elencate le voci richieste sotto ciascuna chiave del Registro di sistema. Il testo CLSID componente aggiuntivo rappresenta l'identificatore univoco globale della classe (CLSID) del componente aggiuntivo. Per ottenere il CLSID del componente aggiuntivo è possibile fare riferimento a uno dei percorsi seguenti:

• Il valore predefinito della voce del Registro di sistema HKEY_CURRENT_USER\Software\Classes\ID componente aggiuntivo\CLSID creata nel computer di sviluppo quando si compila il componente aggiuntivo.

• L'elemento ProjectGuid dei file di progetto csproj (per C#) o vbproj (per Visual Basic).

Nota:
Alcune delle voci del Registro di sistema presenti nell'elenco seguente devono essere create in una sottostruttura ad albero diversa se si sta distribuendo un componente aggiuntivo Microsoft Office 2003 in Windows Vista. Per ulteriori informazioni, vedere Voci del Registro di sistema per i componenti aggiuntivi Microsoft Office 2003 in Windows Vista.

HKEY_CURRENT_USER\Software\Microsoft\Office\<nome applicazione>\Addins\<ID componente aggiuntivo>

Nota:
Per i componenti aggiuntivi di Visio, utilizzare la chiave HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\ID componente aggiuntivo

Voce	Tipo	Valore
Description	REG_SZ	Breve descrizione del componente aggiuntivo.
FriendlyName	REG_SZ	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	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	Percorso completo del manifesto dell'applicazione per il componente aggiuntivo. Deve essere una cartella locale del computer client.

HKEY_CURRENT_USER\Software\Classes\ID componente aggiuntivo

Voce	Tipo	Valore
(Default)	REG_SZ	Descrizione del componente aggiuntivo.

HKEY_CURRENT_USER\Software\Classes\ID componente aggiuntivo\CLSID

Voce	Tipo	Valore
(Default)	REG_SZ	Identificatore univoco globale di classe (CLSID) del componente aggiuntivo.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID componente aggiuntivo>}

Voce	Tipo	Valore
(Default)	REG_SZ	Descrizione del componente aggiuntivo.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID componente aggiuntivo>}\InprocServer32

Voce	Tipo	Valore
(Default)	REG_SZ -oppure- REG_EXPAND_SZ	Percorso completo del caricatore Visual Studio Tools per Office presente nel computer che esegue il componente aggiuntivo. Questa voce deve essere sempre impostata su %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll. Per ulteriori informazioni sul caricatore Visual Studio Tools per Office, vedere Cenni preliminari su Visual Studio Tools per Office Runtime. Nota: Se si utilizza una variabile di ambiente nel percorso, utilizzare il tipo REG_EXPAND_SZ per questa voce. In caso contrario, utilizzare il tipo REG_SZ.
ManifestLocation	REG_SZ	Percorso del manifesto di applicazione del componente aggiuntivo. Deve essere una cartella locale del computer client.
ManifestName	REG_SZ	Nome del manifesto di applicazione per il componente aggiuntivo.
ThreadingModel	REG_SZ	Modello di threading. Questa voce deve essere impostata su Both.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID componente aggiuntivo>}\ProgID

Voce	Tipo	Valore
(Default)	REG_SZ	ID univoco del componente aggiuntivo.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID componente aggiuntivo>}\Programmable

Voce	Tipo	Valore
(Default)	REG_SZ	Non impostare un valore per questa voce.

HKEY_CURRENT_USER\Software\Classes\CLSID\{<CLSID componente aggiuntivo>}\VersionIndependentProgID

Voce	Tipo	Valore
(Default)	REG_SZ	ID univoco indipendente dalla versione del componente aggiuntivo.

Voci del Registro di sistema per i componenti aggiuntivi Microsoft Office 2003 in Windows Vista

Per distribuire un componente aggiuntivo di Microsoft Office 2003 in un computer con Windows Vista, è necessario creare diverse chiavi del Registro di sistema in una differente sottostruttura del Registro di sistema negli scenari seguenti:

• L'utente esegue l'applicazione di Microsoft Office 2003 con un token di accesso completo come amministratore.

  -oppure-

• L'utente ha disattivato la funzionalità Controllo dell'account utente (UAC, User Account Control).

In questi scenari, è necessario creare le chiavi di registrazione COM (ovvero, tutte le chiavi definite sotto HKEY_CURRENT_USER\Software\Classes) sotto HKEY_LOCAL_MACHINE\Software\Classes.

È necessario utilizzare la sottostruttura ad albero del computer perché in questi scenari Windows Vista cerca le chiavi di registrazione COM solo sotto HKEY_LOCAL_MACHINE. Per informazioni sulla modifica delle chiavi del Registro di sistema nel progetto di installazione predefinito, vedere Progetti di installazione dei componenti aggiuntivi a livello di applicazione (2003 System).

Nota:
In questi scenari, evitare di spostare le chiavi del Registro di sistema incluse in HKEY_CURRENT_USER\Software\Microsoft.

Valori di LoadBehavior

La voce LoadBehavior nella chiave HKEY_CURRENT_USER\Software\Microsoft\Office\nome applicazione\Addins\ID componente aggiuntivo include un valore che specifica quando l'applicazione tenta di caricare il componente aggiuntivo e lo stato attuale del componente aggiuntivo (caricavo o non caricato). Per impostazione predefinita, questa voce è impostata su 3 quando si compila o si distribuisce il componente aggiuntivo.

Nella tabella riportata di seguito sono elencati i possibili valori della voce LoadBehavior.

Valore decimale	Significato del valore	Descrizione
0	Non caricato	L'applicazione non tenta di caricare il componente aggiuntivo all'avvio dell'applicazione. L'utente può tentare di caricare manualmente il componente aggiuntivo dalla finestra di dialogo Componenti aggiuntivi COM nell'applicazione.
1	Caricato	L'applicazione non tenta di caricare il componente aggiuntivo all'avvio dell'applicazione. L'utente può tentare di caricare manualmente il componente aggiuntivo dalla finestra di dialogo Componenti aggiuntivi COM nell'applicazione.
2	Carica all'avvio | Non caricato	L'applicazione tenta di caricare il componente aggiuntivo all'avvio dell'applicazione. Se l'applicazione carica correttamente il componente aggiuntivo, il valore di LoadBehavior viene impostato su 3.
3	Carica all'avvio | Caricato	L'applicazione tenta di caricare il componente aggiuntivo all'avvio dell'applicazione. Se l'applicazione carica correttamente il componente aggiuntivo, il valore LoadBehavior rimane 3. Se si verifica un errore durante il caricamento del componente aggiuntivo, il valore LoadBehavior viene impostato su 2.
8	Carica su richiesta | Non caricato	L'applicazione tenta di caricare il componente aggiuntivo solo quando l'applicazione lo richiede, ad esempio quando un utente fa clic su un elemento dell'interfaccia utente (UI) che utilizza la funzionalità nel componente aggiuntivo. Se l'applicazione carica correttamente il componente aggiuntivo, il valore di LoadBehavior viene impostato su 9.
9	Carica su richiesta | Caricato	L'applicazione tenta di caricare il componente aggiuntivo 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. Se l'applicazione carica correttamente il componente aggiuntivo, il valore LoadBehavior rimane 9. Se si verifica un errore durante il caricamento del componente aggiuntivo, il valore LoadBehavior viene impostato su 8.
16	Carica al primo avvio	L'applicazione caricare il componente aggiuntivo quando l'utente esegue l'applicazione per la prima volta. Ai successivi avvii, l'applicazione 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. Se l'applicazione carica correttamente il componente aggiuntivo al successivo avvio dell'applicazione, il valore di LoadBehavior viene impostato su 9.

Vedere anche

Concetti

Architettura dei componenti aggiuntivi a livello di applicazione

Cenni preliminari sul processo di generazione delle soluzioni Office

Distribuzione di soluzioni Office (2007 System)

Distribuzione di componenti aggiuntivi a livello di applicazione (System 2003)

Altre risorse

Architettura di soluzioni Visual Studio Tools per Office