Risoluzione degli errori nelle soluzioni Office

Si è verificato un errore durante il tentativo di creare o aprire un progetto di Office. Le informazioni disponibili sono insufficienti per determinarne la causa. Provare a chiudere il progetto, quindi chiudere e riavviare Visual Studio.

Se si sta tentando di creare un progetto a livello di documento, è possibile che un altro documento con lo stesso nome del documento nel nuovo progetto sia già aperto in Excel o Word. Assicurarsi che tutte le altre istanze di Excel o Word siano chiuse.

Se si crea un nuovo progetto di Office sulla base di un documento derivante da un progetto esistente, le proprietà dei controlli che sono presenti nel documento non verranno copiate nel nuovo progetto. È quindi necessario reimpostare manualmente le proprietà per tutti i controlli preesistenti. In alternativa, è possibile conservare le proprietà dei controlli creando una copia del progetto esistente anziché crearne uno completamente nuovo oppure caricando il progetto esistente nella nuova soluzione (nella finestra di progettazione), quindi copiando e incollando nel nuovo documento i controlli del documento preesistente.

Se si crea un nuovo progetto Cartella di lavoro di Excel basato su una cartella di lavoro esistente, può verificarsi una combinazione degli errori seguenti.

In Excel: "Avviso per la privacy: questo documento contiene macro, controlli ActiveX, informazioni del pacchetto di espansione XML o componenti Web. Potrebbero essere presenti informazioni personali che non possono essere rimosse tramite Controllo documento."

In Visual Studio: "Impossibile caricare correttamente la finestra di progettazione."

Questi errori possono verificarsi se si tenta di creare un progetto basato su una cartella di lavoro le cui informazioni personali sono state rimosse mediante Controllo documento. Per evitare questo errore, eseguire i passaggi seguenti prima della creazione del progetto.

1. Aprire la cartella di lavoro in Excel.

2. In Excel, aprire il Centro protezione.

3. Nella scheda Opzioni privacy deselezionare la casella di controllo Rimuovi le informazioni personali dalle proprietà del file al momento del salvataggio.

4. Salvare la cartella di lavoro e chiudere Excel.

Dopo la migrazione di una soluzione Office a Microsoft Office 2010, il progetto non può essere aperto in un computer di sviluppo in cui è installato solo Microsoft Office System 2007. È possibile che si verifichino gli errori seguenti.

"Uno o più progetti della soluzione non sono stati caricati correttamente. Per dettagli, vedere la finestra di output."

"Impossibile creare il progetto perché l'applicazione associata al tipo di progetto non è installata nel computer. È necessario installare l'applicazione di Microsoft Office associata al tipo di progetto corrente."

Per risolvere questo problema, modificare il file vbproj o csproj. Per un progetto di Word, sostituire HostPackage="{763FDC83-64E5-4651-AC9B-28C4FEB985A1}" con HostPackage="{6CE98B71-D55A-4305-87A8-0D6E368D9600}". Per un progetto di Excel, sostituire HostPackage="{B284B16A-C42C-4438-BDCD-B72F4AC43CFB}" con HostPackage="{825100CF-0BA7-47EA-A084-DCF3308DAF74}". Per un progetto di Outlook, sostituire HostPackage="{D2B20FF5-A6E5-47E1-90E8-463C6860CB05}" con HostPackage="{20A848B8-E01F-4801-962E-25DB0FF57389}".

In alternativa, assicurarsi che i progetti migrati vengano aperti solo in computer di sviluppo in cui sia già installato Microsoft Office 2010.

Se si aggiorna un progetto a livello di documento di Microsoft Office 2003 e il documento contiene i controlli Windows Form, il progetto aggiornato potrebbe presentare errori in fase di compilazione o in fase di esecuzione. Per evitare questo problema, installare Visual Studio 2005 Tools for Office Second Edition Runtime sul computer di sviluppo prima di aggiornare il progetto. La versione di runtime è disponibile come pacchetto ridistribuibile nell'Area download Microsoft in Microsoft Visual Studio 2005 Tools for Office Second Edition Runtime (VSTO 2005 SE) (x86).

Al termine dell'aggiornamento del progetto, è possibile disinstallare Visual Studio 2005 Tools for Office Second Edition Runtime dal computer di sviluppo se non viene utilizzato da altre soluzioni Office.

Nei seguenti casi, non è possibile aprire la finestra di progettazione in Visual Studio:

• Excel o Word è già aperto ed è visualizzata una finestra di dialogo modale. Per aprire la finestra di progettazione, verificare se in Excel o Word è aperta una finestra di dialogo modale, quindi chiudere eventuali finestre di dialogo modali aperte. In assenza di finestre di dialogo modali aperte, potrebbe essere necessario eseguire altre azioni prima che Excel o Word rispondano.

• È in corso il debug del progetto. Per aprire la finestra di progettazione, interrompere o terminare il debug.

• In un componente aggiuntivo di Excel installato nel computer di sviluppo è visualizzata una finestra di dialogo quando Excel viene avviato. Per creare un progetto a livello di documento di Excel, è necessario disabilitare il componente aggiuntivo.

Se si raggruppano controlli in un documento o in un foglio di lavoro, questi controlli non verranno più riconosciuti da Visual Studio. I controlli raggruppati non sono accessibili dalla finestra Proprietà e vengono visualizzati come rettangoli neri nel documento o nel foglio di lavoro. Per ripristinarne la funzionalità, è necessario separare i controlli.

Se si apre un modello di Word nella finestra di progettazione di Visual Studio, i controlli del modello che non sono in linea con il testo potrebbero non essere visibili. Ciò si verifica in quanto in Visual Studio i modelli di Word vengono aperti nella visualizzazione Normale. Per visualizzare i controlli, fare clic sul menu Visualizza, selezionare la visualizzazione di Microsoft Office Word e quindi fare clic su Layout di stampa.

Quando Excel o Word è aperto nella finestra di progettazione di Visual Studio, facendo clic sul pulsante Clip Art nella scheda Illustrazioni della barra multifunzione non si apre il riquadro attività Clip Art. Per aggiungere una ClipArt, è necessario aprire la copia della cartella di lavoro o del documento presente nella cartella principale del progetto (non la copia della cartella \bin) all'esterno di Visual Studio, aggiungere la ClipArt, quindi salvare la cartella di lavoro o il documento.

In alcuni casi, può verificarsi un errore del compilatore analogo al seguente quando si tenta di accedere a un particolare evento di un'istanza di un tipo di assembly di interoperabilità primario (PIA) in un progetto Visual C#.

"Ambiguità tra 'Microsoft.Office.Interop.Excel._Application.NewWorkbook' e 'Microsoft.Office.Interop.Excel.AppEvents_Event.NewWorkbook'"

Questo errore indica che si sta tentando di accedere a un evento che ha lo stesso nome di un'altra proprietà o di un altro metodo dell'oggetto. Per accedere all'evento, è necessario eseguire il cast dell'oggetto all'interfaccia eventi.

I tipi di assembly di interoperabilità primari di Office che dispongono di eventi implementano due interfacce: un'interfaccia principale con tutte le proprietà e i metodi e un'interfaccia eventi che contiene gli eventi esposti dall'oggetto. Queste interfacce eventi utilizzano la convenzione di denominazione nomeoggettoEventsn_Event, ad esempio Microsoft.Office.Interop.Excel.AppEvents_Event e Microsoft.Office.Interop.Word.ApplicationEvents2_Event. Se non è possibile accedere a un evento che si prevede di trovare in un oggetto, eseguire il cast dell'oggetto all'interfaccia eventi.

Ad esempio, gli oggetti Microsoft.Office.Interop.Excel.Application presentano un evento NewWorkbook e una proprietà NewWorkbook. Per gestire l'evento NewWorkbook, eseguire il cast di Microsoft.Office.Interop.Excel.Application all'interfaccia AppEvents_Event. Nell'esempio di codice seguente viene illustrato come eseguire questa operazione in un progetto a livello di documento per Excel.

private void ThisWorkbook_Startup(object sender, System.EventArgs e)
{
    ((Excel.AppEvents_Event)this.Application).NewWorkbook += 
        new Excel.AppEvents_NewWorkbookEventHandler(ThisWorkbook_NewWorkbook);
}

void ThisWorkbook_NewWorkbook(Excel.Workbook Wb)
{
    // Perform some work here.
}

Per ulteriori informazioni sulle interfacce eventi negli assembly di interoperabilità primari di Office, vedere Overview of Classes and Interfaces in the Office Primary Interop Assemblies.

Nei progetti destinati a .NET Framework 4 o .NET Framework 4.5, il codice che fa riferimento a una classe definita in un assembly di interoperabilità primario non viene compilato per impostazione predefinita. Le classi nell'assembly di interoperabilità primario utilizzano la convenzione di denominazione nomeoggettoClass, ad esempio DocumentClass e WorkbookClass. Ad esempio, il codice seguente di un progetto di componente aggiuntivo di Word non viene compilato.

Word.DocumentClass document = (Word.DocumentClass) Globals.ThisAddIn.Application.ActiveDocument;

Questo codice produce i seguenti errori di compilazione:

• Visual Basic: "Riferimento alla classe ‘DocumentClass’ non consentito quando il relativo assembly viene collegato in modalità No-PIA"

• Visual C#: "Impossibile incorporare il tipo di interoperabilità ‘Microsoft.Office.Interop.Word.DocumentClass’. In alternativa, utilizzare l'interfaccia applicabile."

Per risolvere questo errore, modificare il codice in modo che faccia riferimento all'interfaccia corrispondente. Ad esempio, anziché fare riferimento a un oggetto DocumentClass, fare riferimento a un'istanza dell'interfaccia Document.

Word.Document document = Globals.ThisAddIn.Application.ActiveDocument;

I progetti destinati a .NET Framework 4 o .NET Framework 4.5, verranno automaticamente inclusi tutti i tipi di interoperabilità dagli assembly di interoperabilità primari di Office per impostazione predefinita. Questo errore di compilazione si verifica perché la funzionalità dei tipi di interoperabilità incorporati funziona solo con le interfacce, non con le classi. Per ulteriori informazioni su interfacce e classi, negli assembly di interoperabilità primari di Office, vedere i cenni preliminari su classi e interfacce negli assembly di interoperabilità primari di Office. Per ulteriori informazioni sulla funzione dei tipi di interoperabilità incorporati nei progetti Office, vedere Progettazione e creazione di soluzioni Office.

Alcuni nomi di classi, ad esempio Application, sono inclusi in più spazi dei nomi, ad esempio Microsoft.Office.Interop.Word e System.Windows.Forms. Per questo motivo, l'istruzione Imports/using all'inizio dei modelli di progetto include una costante di qualificazione in forma abbreviata, ad esempio:

using Word = Microsoft.Office.Interop.Word;

Questo utilizzo dell'istruzione Imports/using richiede la differenziazione dei riferimenti alle classi di Office con il qualificatore di Word o Excel, ad esempio:

Word.Document doc;

Se si utilizza una dichiarazione senza qualificatore, verranno generati errori. Ad esempio:

Document doc;  // Class is ambiguous

Nonostante l'importazione dello spazio dei nomi di Word o Excel e la possibilità di accedere a tutte le classi in esso contenute, per rimuovere ogni ambiguità relativa allo spazio dei nomi è necessario qualificare tutti i tipi con Word o Excel.

In Visual Studio non è possibile compilare progetti a livello di documento se il documento dispone di autorizzazioni limitate. La compilazione dei progetti che contengono un documento con autorizzazioni limitate avrà esito negativo e nella finestra Elenco errori verrà visualizzato il messaggio seguente:

"Impossibile aggiungere la personalizzazione."

Se si desidera includere un documento con autorizzazioni limitate, utilizzare un documento senza restrizioni durante le lo sviluppo e la compilazione della soluzione. Quindi, dopo aver pubblicato la soluzione, applicare le autorizzazioni limitate al documento nel percorso di pubblicazione.

Se si elimina un controllo NamedRange da un foglio di lavoro che non è il foglio di lavoro attivo nella finestra di progettazione, il codice generato automaticamente potrebbe non essere rimosso dal progetto e potrebbero verificarsi errori del compilatore. Per assicurarsi che il codice venga rimosso, selezionare sempre il foglio di lavoro contenente il controllo NamedRange in modo da impostarlo come foglio di lavoro attivo prima di eliminare il controllo. Se il codice generato automaticamente non viene eliminato quando si rimuove il controllo, è possibile eliminarlo mediante la finestra di progettazione attivando il foglio di lavoro e apportandovi una modifica in modo che il foglio venga contrassegnato come modificato. La ricompilazione del progetto comporterà la rimozione del codice.

Quando si esegue il debug di una soluzione Office, è possibile che si verifichi l'errore seguente.

Impossibile installare la personalizzazione perché ne è installata un'altra versione che non può essere aggiornata da questo percorso".

Questo errore indica che la soluzione Office è stata pubblicata e installata precedentemente nel computer di sviluppo. Per evitare che venga visualizzato questo messaggio, disinstallare la soluzione dall'elenco di programmi installati nel computer prima di eseguire il debug della soluzione. In alternativa, è possibile creare un altro account utente nel computer di sviluppo per testare l'installazione della soluzione pubblicata.

Se si crea un progetto a livello di documento per Excel o Word su un percorso di rete UNC, è necessario aggiungere il percorso del documento all'elenco di percorsi attendibili in Excel o Word. In caso contrario, la personalizzazione non verrà caricata quando si tenta di eseguire il progetto o di eseguirne il debug in Visual Studio. Per ulteriori informazioni sui percorsi attendibili, vedere Concessione dell'attendibilità ai documenti.

I progetti di Office in Visual Studio sono conformi a una convenzione di denominazione dei thread che consente al debugger di chiudere il programma nel modo corretto. Al nome dei thread creati nella soluzione è necessario assegnare al nome di ciascun thread il prefisso VSTA_ per consentirne la corretta gestione quando si interrompe il debug. È possibile, ad esempio, impostare la proprietà Name di un thread che attende un evento di rete su VSTA_NetworkListener.

Se non è possibile eseguire o sviluppare un progetto di Office nel computer di sviluppo, potrebbe venire visualizzato il messaggio di errore seguente.

"Impossibile creare il dominio applicazione. Personalizzazione non caricata."

Visual Studio utilizza Fusion, il caricatore di assembly .NET Framework, per memorizzare nella cache gli assembly prima di caricare le soluzioni Office. Verificare che Visual Studio sia in grado di scrivere nella cache di Fusion, quindi riprovare. Per ulteriori informazioni, vedere Creazione di copie replicate di assembly.

Se si utilizza Modifica e continuazione per apportare modifiche al codice in un progetto a livello di documento per Excel o Word mentre il progetto è in modalità di interruzione, può venire visualizzata una finestra di dialogo con il messaggio di errore seguente se successivamente si arresta il debugger.

"L'interruzione del processo nello stato corrente può causare effetti indesiderati, incluse la perdita dei dati e l'instabilità del sistema."

Sia che si faccia clic su Sì o su No nella finestra di dialogo, viene interrotto il processo di Excel o Word e viene arrestato il debugger. Per interrompere il debug del progetto senza visualizzare questa finestra di dialogo, uscire direttamente da Excel o Word anziché arrestare il debugger in Visual Studio.