Risoluzione di errori specifici nelle distribuzioni ClickOnce

In questo argomento sono elencati gli errori più frequenti che possono verificarsi durante la distribuzione di un'applicazione ClickOnce e vengono descritte le operazioni necessarie per la risoluzione di ciascun problema.

Errori generali

Quando si tenta di individuare un file con estensione application, non viene eseguita alcuna azione, il rendering XML viene eseguito in Internet Explorer o viene visualizzata una finestra di dialogo Esegui come o Salva con nome.

La causa più probabile di questo errore è una registrazione non corretta dei tipi di contenuto, conosciuti anche come tipi MIME, sul server o sul client.

Verificare innanzitutto che il server sia configurato per associare l'estensione application al tipo di contenuto "application/x-ms-application".

Se il server è configurato correttamente, verificare che .NET Framework 2.0 sia installato nel computer.Se .NET Framework 2.0 risulta installato, ma il problema persiste, provare a disinstallare e reinstallare .NET Framework 2.0 per registrare nuovamente il tipo di contenuto sul client.

Viene visualizzato il messaggio di errore "Impossibile recuperare l'applicazione.File mancanti nella distribuzione" oppure "Download dell'applicazione interrotto. Controllare se si sono verificati errori di rete e riprovare più tardi".

Un messaggio di questo tipo indica che non è possibile scaricare uno o più file cui viene fatto riferimento nei manifesti di ClickOnce.Il metodo più semplice per risolvere l'errore consiste nel provare a scaricare l'URL per il quale in ClickOnce non è possibile eseguire il download.Di seguito sono riportate alcune delle possibili cause:

• Se nel file di log è riportato il messaggio "(403) Accesso negato" o "(404) Pagina non trovata", verificare che il server Web sia configurato in modo da non bloccare il download del file.Per ulteriori informazioni, vedere Problemi relativi alla configurazione del server e del client nelle distribuzioni ClickOnce.

• Se il file con estensione config viene bloccato dal server, vedere la sezione "Quando si tenta di installare un'applicazione ClickOnce in cui è incluso un file config, si verifica un errore di download" più avanti in questo argomento.

• Stabilire se si è verificata questa condizione in quanto l'URL definito nella proprietà deploymentProvider nel manifesto di distribuzione sta puntando a un percorso diverso dall'URL utilizzato per l'attivazione.

• Assicurarsi che sul server siano presenti tutti i file. Gli eventuali file non trovati dovrebbero essere indicati nel log ClickOnce.

• Verificare se sono presenti problemi di connettività di rete. È possibile che questo messaggio venga visualizzato se la connessione del computer client si è interrotta durante il download.

Quando si tenta di installare un'applicazione ClickOnce in cui è incluso un file config, si verifica un errore di download.

Per impostazione predefinita, in un'applicazione Visual Basic per Windows è incluso un file App.config.Quando un utente prova a eseguire l'installazione da un server Web con sistema operativo Windows Server 2003, si verifica un errore perché l'installazione di file con estensione config viene bloccata per motivi di sicurezza.Per consentire l'installazione del file config, selezionare la casella di controllo Usa estensione ".deploy" nella finestra di dialogo Opzioni di pubblicazione.

È inoltre necessario impostare i tipi di contenuto, conosciuti anche come tipi MIME, per i file con estensione application, manifest e deploy.Per ulteriori informazioni, vedere la documentazione del server Web.

Per ulteriori informazioni, vedere "Windows Server 2003: tipi di contenuto bloccati" in Problemi relativi alla configurazione del server e del client nelle distribuzioni ClickOnce.

Messaggio di errore "Applicazione formattata in modo non corretto" ed errore "Firma XML non valida" riportato nel file di log.

Assicurarsi di aver aggiornato il file manifesto e di averlo nuovamente firmato.Pubblicare di nuovo l'applicazione con Visual Studio oppure utilizzare Mage per applicare di nuovo la firma.

L'applicazione è stata aggiornata sul server, ma il client non scarica l'aggiornamento.

Il problema potrebbe essere risolto completando una delle attività seguenti:

• Esaminare l'URL definito nella proprietà deploymentProvider nel manifesto di distribuzioneper verificare se i componenti aggiornati sono presenti nel percorso a cui punta la proprietà deploymentProvider.

• Verificare l'intervallo di aggiornamento nel manifesto di distribuzione.Se è impostato un intervallo periodico, ad esempio ogni sei ore, in ClickOnce non verrà verificata la disponibilità di aggiornamenti prima che sia trascorso tale intervallo.È possibile modificare il manifesto in modo che venga verificata la disponibilità di un aggiornamento a ogni avvio dell'applicazione.La modifica dell'intervallo di aggiornamento è utile in fase di sviluppo per verificare se gli aggiornamenti vengono installati, ma rallenta l'attivazione dell'applicazione.

• Provare a riavviare l'applicazione dal menu Start.È possibile che in ClickOnce sia stato rilevato l'aggiornamento in background, ma che venga richiesto di installare i componenti aggiornati alla successiva attivazione.

Durante l'aggiornamento viene visualizzato un errore che nel file di log è segnalato come "Riferimento nella distribuzione non corrispondente all'identità definita nel manifesto dell'applicazione".

Questo errore potrebbe verificarsi in quanto i manifesti di distribuzione e dell'applicazione sono stati modificati manualmente e di conseguenza le descrizioni dell'identità di un assembly in due manifesti non sono più sincronizzate.L'identità di un assembly è costituita dai seguenti elementi: nome, versione, impostazioni cultura e token di chiave pubblica.Esaminare le descrizioni dell'identità nei manifesti e correggere le eventuali differenze.

La prima attivazione da disco locale o CD-ROM viene eseguita correttamente, mentre quella successiva dal menu Start non riesce.

Per ottenere gli aggiornamenti dell'applicazione, ClickOnce utilizza l'URL definito nella proprietà deploymentProvider.Verificare che il percorso a cui punta L'URL sia corretto.

Errore: "Impossibile avviare l'applicazione".

Questo messaggio di errore indica in genere un problema relativo all'installazione dell'applicazione nell'archivio di ClickOnce.È possibile che l'applicazione contenga un errore oppure che l'archivio sia danneggiato.Il file di log potrebbe indicare dove si è verificato l'errore.

Si dovrebbe effettuare quanto segue:

• Controllare che il manifesto di distribuzione, il manifesto dell'applicazione e il file eseguibile dell'applicazione principale abbiano tutti identità univoche.

• Verificare che i percorsi dei file non superino i 100 caratteri.Se l'applicazione contiene percorsi troppo lunghi, è possibile che vengano superate le limitazioni relative al percorso massimo archiviabile.Provare a ridurre la lunghezza dei percorsi ed eseguire nuovamente l'installazione.

Le impostazioni di PrivatePath nel file config dell'applicazione non vengono rispettate.

Per l'utilizzo di PrivatePath (percorsi di sondaggio Fusion), l'applicazione deve richiedere l'autorizzazione di attendibilità totale.Provare a modificare il manifesto dell'applicazione in modo da richiedere l'attendibilità totale e riprovare.

Durante la disinstallazione dell'applicazione viene visualizzato un messaggio per segnalare che non è stato possibile completare l'operazione.

Questo messaggio indica in genere che l'applicazione è già stata rimossa oppure che l'archivio è danneggiato.Se si sceglie OK, la voce relativa all'applicazione verrà rimossa da Installazione applicazioni.

Durante l'installazione, viene visualizzato un messaggio che indica che le dipendenze della piattaforma non sono installate.

Nella Global Assembly Cache non è presente un prerequisito per l'esecuzione dell'applicazione.

Pubblicazione con Visual Studio

Non è possibile eseguire una pubblicazione in Visual Studio.

Assicurarsi di disporre del diritto di pubblicazione sul server di destinazione.Se ad esempio si è connessi a un server terminal come utente normale e non come amministratore, è probabile che non si disponga dei diritti necessari per la pubblicazione sul server Web locale.

Se si esegue la pubblicazione tramite URL, assicurarsi che nel computer di destinazione siano attivate le estensioni del server di FrontPage.

Messaggio di errore: Impossibile creare il sito Web '<sito>'.I componenti per la comunicazione con le estensioni del server di FrontPage non sono installati.

Assicurarsi che Microsoft Visual Studio Web Authoring Component sia installato nel computer da cui si esegue la pubblicazione.Per gli utenti Express, il componente non è installato per impostazione predefinita.Per ulteriori informazioni, vedere il sito all'indirizzo https://go.microsoft.com/fwlink/?LinkId=102310 (informazioni in lingua inglese).

messaggio di errore: Impossibile trovare il file “Microsoft.Windows.Common-Controls, Version= 6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32„

Questo messaggio di errore viene visualizzato quando si tenta di pubblicare un'applicazione WPF con gli stili visivi abilitati.per risolvere questo problema, vedere Procedura: pubblicare un'applicazione WPF per la quale sono attivati gli stili di visualizzazione.

Utilizzo di Mage

Si è tentato di firmare con un certificato incluso nell'archivio certificati ma è stata visualizzata una finestra di messaggio vuota.

Nella finestra di dialogo Firma è necessario effettuare le seguenti operazioni:

• Selezionare Firma con un certificato archiviato.

• Selezionare un certificato dall'elenco. Il primo certificato non rappresenta la selezione predefinita.

La selezione del pulsante "Non firmare" determina la generazione di un'eccezione.

Si tratta di un bug noto.Tutti i manifesti di ClickOnce devono essere firmati.Selezionare una delle opzioni di firma e scegliere OK.

Altri possibili errori

Nella seguente tabella sono elencati alcuni messaggi di errore comuni che possono essere visualizzati su un computer client quando l'utente installa un'applicazione ClickOnce.Accanto a ciascun messaggio è riportata la descrizione della causa più probabile dell'errore.

Messaggio di errore	Descrizione
Impossibile avviare l'applicazione.Contattare l'editore. Impossibile avviare l'applicazione.Contattare il fornitore per assistenza.	Si tratta di messaggi di errore generici che vengono visualizzati quando non è possibile avviare l'applicazione, senza altri motivi specifici.Indicano spesso che l'applicazione o l'archivio di ClickOnce è danneggiato.
Impossibile continuare.Applicazione non formattata correttamente.Contattare l'editore per assistenza. Convalida dell'applicazione non riuscita.Impossibile continuare. Impossibile recuperare i file dell'applicazione.File danneggiati nella distribuzione.	In uno dei file manifesto della distribuzione la sintassi non è corretta oppure è presente un hash che non può essere riconciliato con il file corrispondente.Questo errore può anche indicare che il manifesto incorporato in un assembly è danneggiato.Creare una nuova distribuzione e ricompilare l'applicazione oppure individuare e correggere gli errori manualmente nei manifesti.
Impossibile recuperare l'applicazione.Errore di autenticazione. Installazione dell'applicazione non riuscita.Impossibile trovare i file dell'applicazione sul server.Contattare l'editore dell'applicazione o l'amministratore per assistenza.	Non è possibile scaricare uno o più file della distribuzione perché non si dispone dell'autorizzazione di accesso appropriata.Questo problema può essere dovuto a un errore 403 (accesso negato) restituito da un server Web, che può verificarsi se uno dei file della distribuzione termina con un'estensione in base alla quale viene identificato come file protetto.È anche possibile che per l'accesso a una directory contenente uno o più file dell'applicazione siano necessari un nome utente e una password.
Impossibile scaricare l'applicazione.File necessari mancanti.Contattare il fornitore dell'applicazione o l'amministratore di sistema per assistenza.	Non è possibile trovare uno o più file elencati nel manifesto dell'applicazione sul server.Verificare che siano stati caricati tutti i file dipendenti della distribuzione e riprovare.
Download dell'applicazione non riuscito.Verificare la connessione di rete oppure contattare l'amministratore di sistema o il provider di servizi di rete.	ClickOnce non riesce a stabilire una connessione di rete con il server.Controllare la disponibilità del server e lo stato della rete.
URLDownloadToCacheFile non riuscito con HRESULT '<numero>'.Errore durante il download di '<file>'.	Se un utente ha impostato l'opzione di sicurezza avanzata di Internet Explorer "Avvisa se si passa da modalità protetta a non protetta" nel computer di destinazione della distribuzione e se l'URL di installazione dell'applicazione ClickOnce in fase di installazione è reindirizzato da un sito non sicuro a un sito sicuro (o viceversa), l'installazione non riuscirà, perché verrà interrotta dall'avviso di Internet Explorer. Per risolvere il problema, è possibile effettuare una delle seguenti operazioni: Deselezionare l'opzione di sicurezza. Verificare che l'URL di installazione non sia reindirizzato in modo da modificare le modalità di sicurezza. Rimuovere completamente il reindirizzamento e puntare all'URL di installazione effettivo.
Errore durante la scrittura sul disco rigido.È possibile che lo spazio disponibile sia insufficiente.Contattare il fornitore dell'applicazione o l'amministratore di sistema per assistenza.	È possibile che lo spazio disponibile su disco non sia sufficiente per l'applicazione, oppure che si sia verificato un errore più generale di I/O durante il tentativo di salvare i file dell'applicazione nell'unità.
Impossibile avviare l'applicazione.Spazio disponibile su disco insufficiente.	Il disco rigido è pieno.Rendere disponibile dello spazio e provare nuovamente ad avviare l'applicazione.
Tentativo di caricare contemporaneamente troppe applicazioni distribuite.	ClickOnce prevede un limite per il numero di applicazioni che è possibile avviare contemporaneamente.Questa restrizione viene applicata allo scopo di proteggere da tentativi di istigazione di attacchi Denial of Service contro il servizio ClickOnce locale. Gli utenti che tentano di avviare più volte la stessa applicazione, in successione rapida, potranno comunque disporre di una sola istanza dell'applicazione.
Impossibile attivare collegamenti sulla rete.	È possibile avviare collegamenti a un'applicazione ClickOnce solo sul disco rigido locale,e non tramite un URL che punta a un file di collegamento su un server remoto.
Applicazione troppo grande per l'esecuzione online con attendibilità parziale.Contattare il fornitore dell'applicazione o l'amministratore di sistema per assistenza.	Un'applicazione eseguita con autorizzazioni di attendibilità parziale non può avere una dimensione superiore alla metà della quota per applicazioni online, che per impostazione predefinita è pari a 250 MB.

Vedere anche

Concetti

Sicurezza e distribuzione di ClickOnce

Risoluzione dei problemi relativi alle distribuzioni ClickOnce