Fuslogvw.exe (Visualizzatore log associazioni assembly)

Il Visualizzatore log associazione assembly consente di visualizzare i dettagli relativi alle associazioni di assembly. Queste informazioni consentono di diagnosticare per quale motivo non sia possibile individuare un assembly in fase di esecuzione. Gli errori individuati sono generalmente dovuti alla distribuzione di un assembly nel percorso errato, a un'immagine nativa che non è più valida o a una mancata corrispondenza di numeri di versione o impostazioni cultura. L'impossibilità di Common Language Runtime di individuare un assembly produce generalmente un'eccezione TypeLoadException.

Questo strumento viene installato automaticamente con Visual Studio e con Windows SDK. Per eseguire lo strumento, si consiglia di utilizzare il prompt dei comandi di Visual Studio o il prompt dei comandi di Windows SDK (shell di CMD). Queste utilità consentono di eseguire facilmente lo strumento, senza dover passare alla cartella di installazione. Per ulteriori informazioni, vedere Prompt dei comandi di Visual Studio e Windows SDK.

• Se si dispone di Visual Studio installato sul computer: nella barra delle applicazioni, fare clic su Start, fare clic su All Programs, fare clic su Visual Studio, fare clic su Visual Studio Tools e quindi su Visual Studio Command Prompt.

  In alternativa

  Se si dispone di Windows SDK installato sul computer: nella barra delle applicazioni, fare clic su Start, fare clic su All Programs, fare clic sulla cartella di Windows SDK e quindi su Command Prompt (o CMD Shell).

• Al prompt dei comandi digitare quanto segue:

fuslogvw

Nel visualizzatore è riportata una voce per ciascuna associazione di assembly non riuscita. Per ciascun errore vengono descritti l'applicazione che ha avviato l'associazione, l'assembly interessato, inclusi il nome, la versione, le impostazioni cultura e la chiave pubblica, nonché la data e l'ora dell'errore.

Per modificare la visualizzazione del percorso del registro

1. Selezionare il pulsante di opzione Default (Predefinito) per visualizzare gli errori di associazione per tutti i tipi di applicazione. Per impostazione predefinita, le voci di log vengono archiviate in directory specifiche per utente su disco, nella cache di wininet.

2. Selezionare il pulsante di opzione Custom per visualizzare gli errori di associazione in una directory personalizzata specificata. È necessario specificare il percorso personalizzato in cui devono essere archiviati i log impostando il percorso di log personalizzato su un nome di directory valido nella finestra di dialogo Log Settings (Impostazioni log). Tale directory deve essere pulita e contenere solo file generati dal runtime. Se contiene un file eseguibile che genera un errore da registrare, l'errore non verrà registrato poiché lo strumento cercherà di creare una directory con lo stesso nome del file eseguibile. Inoltre, il tentativo di esecuzione di un eseguibile dal registro avrà esito negativo.

   Nota
   È preferibile utilizzare il percorso di associazione predefinito anziché quello personalizzato.Il runtime memorizza il percorso di associazione predefinito nella cache di wininet e rimuove tali informazioni automaticamente.Se si specifica un percorso di associazione personalizzato la pulitura dovrà essere eseguita manualmente.

Per visualizzare i dettagli relativi a un errore specifico

1. Nel visualizzatore selezionare il nome dell'applicazione dalla voce desiderata.

2. Fare clic sul pulsante Visualizza file di log. In alternativa è possibile fare doppio clic sulla voce selezionata.

   Nello strumento vengono visualizzati i seguenti dettagli relativi all'errore di associazione selezionato:

   • Causa specifica dell'errore, ad esempio irreperibilità del file o incompatibilità di versioni.

   • Informazioni sull'applicazione con cui è stata avviata l'associazione, inclusi il nome, la directory radice dell'applicazione (AppBase) e una descrizione del percorso di ricerca privato, se presente.

   • Identità dell'assembly cercato.

   • Descrizione dei criteri di controllo delle versioni applicati a livello di applicazione, editore o amministratore.

   • Provenienza o meno dell'assembly dalla Global Assembly Cache.

   • Elenco di tutti gli URL di ricerca.

Nell'esempio riportato di seguito viene illustrata una voce del registro in cui sono visualizzate informazioni dettagliate su un'associazione di assembly non riuscita.

*** Assembly Binder Log Entry  (3/5/2007 @ 12:54:20 PM) ***

The operation failed.
Bind result: hr = 0x80070002. The system cannot find the file specified.

Assembly manager loaded from:  C:\WINNT\Microsoft.NET\Framework\v2.0.50727\fusion.dll
Running under executable  C:\Program Files\Microsoft.NET\FrameworkSDK\Samples\Tutorials\resourcesandlocalization\graphic\cs\graphicfailtest.exe
--- A detailed error log follows. 

=== Pre-bind state information ===
LOG: DisplayName = graphicfailtest.resources, Version=0.0.0.0, Culture=en-US, PublicKeyToken=null
 (Fully-specified)
LOG: Appbase = C:\Program Files\Microsoft.NET\FrameworkSDK\Samples\Tutorials\resourcesandlocalization\graphic\cs\
LOG: Initial PrivatePath = NULL
LOG: Dynamic Base = NULL
LOG: Cache Base = NULL
LOG: AppName = NULL
Calling assembly : graphicfailtest, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
===

LOG: Processing DEVPATH.
LOG: DEVPATH is not set. Falling through to regular bind.
LOG: Policy not being applied to reference at this time (private, custom, partial, or location-based assembly bind).
LOG: Post-policy reference: graphicfailtest.resources, Version=0.0.0.0, Culture=en-US, PublicKeyToken=null
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources.DLL.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources/graphicfailtest.resources.DLL.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources.EXE.
LOG: Attempting download of new URL file:///C:/Program Files/Microsoft.NET/FrameworkSDK/Samples/Tutorials/resourcesandlocalization/graphic/cs/en-US/graphicfailtest.resources/graphicfailtest.resources.EXE.
LOG: All probing URLs attempted and failed.

Per eliminare una singola voce dal registro

1. Selezionare una voce nel visualizzatore.

2. Fare clic sul pulsante Elimina voce.

Per eliminare tutte le voci dal registro

• Fare clic sul pulsante Elimina tutto.

Per aggiornare l'interfaccia utente

• Scegliere il pulsante Aggiorna. Il visualizzatore non rileva automaticamente le nuove voci di registro quando è in esecuzione. Per visualizzarle è necessario fare clic sul pulsante Aggiorna.

Per modificare le impostazioni del log

• Scegliere il pulsante Settings (Impostazioni) per visualizzare la finestra di dialogo Log Settings (Impostazioni log).

Per visualizzare la finestra di dialogo About

• Scegliere il pulsante About (Informazioni su).

Log associazioni per immagini native

Per impostazione predefinita, Fuslogvw.exe registra le normali richieste di associazione di assembly. In alternativa, è possibile registrare le associazioni di assembly per le immagini native create utilizzando Ngen.exe (generatore di immagini native).

Per registrare le associazioni di assembly per le immagini native

• Nel gruppo Categorie log, selezionare il pulsante di opzione Immagini native.

Nel log seguente viene riportato un errore causato da una dipendenza inesistente nel momento in cui è stata creata l'immagine nativa per l'applicazione. Se le dipendenze in fase di esecuzione differiscono dalle dipendenze durante l'esecuzione di Ngen.exe, l'associazione a un'immagine nativa non è consentita.

*** Assembly Binder Log Entry  (12/8/2006 @ 5:22:07 PM) ***

The operation failed.
Bind result: hr = 0x80070002. The system cannot find the file specified.

Assembly manager loaded from:  E:\Windows\Microsoft.NET\Framework64\v2.0.50727\mscorwks.dll
Running under executable  E:\test\App.exe
--- A detailed error log follows. 

LOG: Start binding of native image App, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: IL assembly loaded from E:\test\App.exe.
LOG: Start validating native image App, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: Start validating all the dependencies.
LOG: [Level 1]Start validating native image dependency mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.
LOG: Dependency evaluation succeeded.
LOG: [Level 1]Start validating IL dependency b, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
WRN: Dependency assembly was not found at ngen time, but is found at binding time. Disallow using this native image.
WRN: No matching native image found.
LOG: Bind to native image assembly did not succeed. Use IL image.

Nel log seguente viene riportato un errore di associazione dell'immagine nativa che si è verificato perché le impostazioni di sicurezza del computer nel momento in cui è stata eseguita l'applicazione erano diverse da quelle impostate al momento della creazione dell'immagine nativa.

*** Assembly Binder Log Entry  (12/8/2006 @ 5:29:09 PM) ***

The operation failed.
Bind result: hr = 0x80004005. Unspecified error

Assembly manager loaded from:  E:\Windows\Microsoft.NET\Framework64\v2.0.50727\mscorwks.dll
Running under executable  E:\test\Application101622.exe
--- A detailed error log follows. 

LOG: Start binding of native image Application101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: IL assembly loaded from E:\test\Application101622.exe.
LOG: Start validating native image Application101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: Start validating all the dependencies.
LOG: [Level 1]Start validating native image dependency mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089.
LOG: Dependency evaluation succeeded.
LOG: [Level 1]Start validating IL dependency Dependency101622, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null.
LOG: Dependency evaluation succeeded.
LOG: Validation of dependencies succeeded.
LOG: Start loading all the dependencies into load context.
LOG: Loading of dependencies succeeded.
LOG: Bind to native image succeeded.
Native image has correct version information.
Attempting to use native image E:\Windows\assembly\NativeImages_v2.0.50727_64\Application101622\1ac7fadabec4f72575d807501e9fdc72\Application101622.ni.exe.
Rejecting native image because it failed the security check. The assembly's permissions must have changed since the time it was ngenned, or it is running with a different security context.
Discarding native image.

Finestra di dialogo Log Settings

È possibile utilizzare la finestra di dialogo Log Settings (Impostazioni log) per definire le seguenti impostazioni.

Per disabilitare la registrazione

• Selezionare il pulsante di opzione Log disabled (Log disabilitato). Questa opzione è selezionata per impostazione predefinita.

Per registrare le associazioni di assembly in eccezioni

• Selezionare il pulsante di opzione Log in exception text (Registra nel testo dell'eccezione).

  Vedere la nota Importante relativa agli assembly caricati come indipendenti dal dominio.

Per registrare gli errori di associazione di assembly

• Selezionare il pulsante di opzione Log bind failures to disk (Registra errori di associazione su disco).

  Vedere la nota Importante relativa agli assembly caricati come indipendenti dal dominio.

Per registrare tutte le associazioni di assembly

• Selezionare il pulsante di opzione Log all binds to disk (Registra tutte le associazioni su disco).

  Vedere la nota Importante relativa agli assembly caricati come indipendenti dal dominio.

Importante

Quando un assembly viene caricato come indipendente dal dominio, ad esempio impostando la proprietà LoaderOptimization su LoaderOptimization.MultiDomain o LoaderOptimization.MultiDomainHost, l'attivazione della registrazione può determinare una perdita di memoria in alcuni casi.Ciò può verificarsi se si crea una voce di log quando in un dominio applicazione viene caricato un modulo indipendente dal dominio e successivamente il dominio applicazione viene scaricato.È possibile che la voce di log non venga rilasciata fino alla fine del processo.Alcuni debugger prevedono l'attivazione automatica della registrazione.

Per impostare un percorso di log personalizzato

1. Selezionare il pulsante di opzione Enable custom log path (Attiva percorso personalizzato log).

2. Immettere il percorso nella casella di testo Custom log path (Percorso personalizzato log).

Nota

Per l'archiviazione del registro associazione di Fuslogvw.exe (Visualizzatore log associazioni assembly) viene utilizzato Internet Explorer.In seguito al danneggiamento occasionale della cache di Internet Explorer, è possibile che in Fuslogvw.exe (Visualizzatore log associazioni assembly) non vengano più visualizzati nuovi registri associazione nella finestra di visualizzazione.In tali circostanze l'infrastruttura di associazione di .NET (fusion) non è in grado di eseguire operazioni di scrittura o lettura dal registro associazione.Questo problema non viene rilevato se si utilizza un percorso personalizzato per il registro. Per correggere il problema che ha causato il danneggiamento e riattivare la visualizzazione dei registri associazione in fusion, cancellare la cache di Internet Explorer eliminando i file temporanei Internet nella finestra di dialogo Opzioni Internet del programma. Se l'applicazione non gestita ospita Common Language Runtime mediante l'implementazione delle interfacce IHostAssemblyManager e IHostAssemblyStore, le voci di logo non possono essere memorizzate nella cache wininet.Per visualizzare le voci di log di host personalizzati che implementano tali interfacce, è necessario specificare un percorso alternativo per il log.

Vedere anche

Riferimenti

TypeLoadException

Prompt dei comandi di Visual Studio e Windows SDK

Concetti

Global Assembly Cache

Come il runtime individua gli assembly

Altre risorse

Strumenti di .NET Framework

Cronologia delle modifiche

Data	Cronologia	Motivo
Aprile 2011	Sono state aggiunte informazioni sull'utilizzo di Visual Studio e dei prompt dei comandi di Windows SDK.	Miglioramento delle informazioni.