Strumento di registrazione del browser ASP.NET (Aspnet_regbrowsers.exe)
Lo strumento di registrazione del browser ASP.NET (Asnet_regbrowsers.exe) consente di analizzare e compilare tutte le definizioni di browser a livello di sistema in un assembly e di installare l'assembly nella Global Assembly Cache. Lo strumento impiega i file di definizione del browser (con estensione BROWSER) presenti nella sottodirectory Browsers di .NET Framework
Nota
Per informazioni su come individuare la versione corretta di Asnet_regbrowsers.exe, vedere Individuazione della versione corretta di Aspnet_regbrowsers.exe più avanti in questo argomento.
Sintassi
aspnet_regbrowsers.exe <options>
Opzioni
Opzione |
Descrizione |
|---|---|
-? |
Consente di visualizzare il testo della Guida di Aspnet_regbbrowsers.exe nella finestra di comando. |
-i |
Consente di creare l'assembly con funzionalità browser di runtime e di installarlo nella Global Assembly Cache. |
-u |
Consente di disinstallare l'assembly con funzionalità browser di runtime dalla Global Assembly Cache. |
Osservazioni
I file di definizione del browser possono essere a livello di sistema o specifici di un'applicazione ed essere memorizzati ciascuno in una posizione diversa. I file di definizione del browser a livello di sistema vengono archiviati nel percorso seguente:
%SystemRoot%\Microsoft.NET\Framework\versione\CONFIG\Browsers
Questa directory contiene i file di definizione del browser predefiniti disponibili nella versione corrispondente di .NET Framework e altri file aggiuntivi di questo tipo copiati in tale posizione dagli aggiornamenti software o dai service pack. È possibile aggiungere nuovi file del browser per le definizioni del browser che si desidera rendere globalmente disponibili per le applicazioni Web. Evitare tuttavia di modificare i file di definizione del browser predefiniti disponibili in ASP.NET, perché questi file potrebbero essere aggiornati dai service pack, sovrascrivendo le modifiche.
I file di definizione del browser specifici di un'applicazione possono essere memorizzati nella directory App_Browsers dell'applicazione. L'utilizzo dello strumento di registrazione del browser ASP.NET non influisce sui file di definizione del browser specifici di un'applicazione memorizzati nella directory App_Browsers di un'applicazione.
La modifica dei file di definizione del browser a livello di sistema non determina un aggiornamento delle funzionalità browser di tutte le applicazioni. Per aggiornare l'assembly con funzionalità browser è necessario infatti eseguire lo strumento di registrazione del browser ASP.NET.
Nota
Lo strumento di registrazione del browser ASP.NET consente di compilare le definizioni del browser presenti nella directory Browser in %SystemRoot%, che corrisponde alla directory Framework in %WinDir% da cui è stato eseguito il browser.La versione dello strumento inclusa in .NET Framework 2.0 aggiorna l'assembly di definizione del browser per i siti Web destinati a .NET Framework 2.0, .NET Framework 3.0 o .NET Framework 3.5. La versione inclusa in .NET Framework 4 aggiorna l'assembly di definizione del browser per i siti Web destinati a .NET Framework 4.
Lo strumento di registrazione del browser ASP.NET consente di analizzare e compilare tutte le definizioni di browser del sistema in un assembly e di installare l'assembly nella Global Assembly Cache e segnala gli eventuali errori nelle definizioni a livello di sistema. L'assembly con funzionalità browser viene utilizzato da tutte le applicazioni Web del sistema. È possibile anche ricompilare i file di definizione del browser del sistema a livello di codice utilizzando la classe BrowserCapabilitiesCodeGenerator.
Comportamento
L'esecuzione dello strumento di registrazione del browser ASP.NET determina la creazione di un nuovo assembly e produce su tutte le applicazioni Web lo stesso effetto derivante dalla modifica del file Machine.config, ovvero il riciclo di tutte le applicazioni Web in esecuzione e il riavvio di Microsoft Internet Information Services (IIS). Lo strumento consente inoltre di generare un file di token privato casuale e un file di chiave da utilizzare per la firma dell'assembly in modo che quest'ultimo possa essere installato nella Global Assembly Cache. Al termine dell'esecuzione dello strumento, il file di chiave viene rimosso lasciando solo la chiave pubblica.
In fase di esecuzione le informazioni relative alla definizione del browser vengono uniti in un insieme di browser conosciuti in un oggetto BrowserCapabilitiesFactory. Quando viene effettuata una richiesta, ASP.NET identifica il browser richiedente dall'intestazione della richiesta e compila un oggetto HttpBrowserCapabilities che corrisponde al tipo del browser richiesto.
Nota
In .NET Framework 1.1 le definizioni del browser vengono archiviate nell'elemento browserCaps del file Web.config.Questa sezione è deprecata in .NET Framework versione 2.0, ma ancora è supportata.I dati contenuti in questo elemento vengono uniti alle informazioni dei file di definizione del browser.
I file di definizione del browser a livello di applicazione vengono analizzati e compilati con gli altri file di origine dell'applicazione. Per un progetto di sito Web la compilazione viene eseguita su richiesta all'avvio dell'applicazione che viene ricompilata automaticamente in caso di modifiche alla directory Browser dell'applicazione. Lo strumento di registrazione del browser ASP.NET non influisce sui file di informazioni di visualizzazione a livello di applicazione.
Esempi
Per analizzare e compilare tutte le definizioni del browser a livello di sistema in un assembly e installare l'assembly nella Global Assembly Cache, eseguire il comando seguente.
aspnet_ regbrowsers.exe -i
Lo strumento consente anche di rimuovere l'assembly di definizioni del browser dalla Global Assembly Cache. Per eseguire tale operazione, utilizzare il comando seguente:
aspnet_ regbrowsers.exe -u
Per visualizzare le informazioni della Guida sull'utilizzo dello strumento di registrazione del browser ASP.NET, utilizzare il comando seguente:
aspnet_ regbrowsers.exe -?
Individuazione della versione corretta di Aspnet_regbrowsers.exe
Aspnet_regbrowsers.exe viene installato nella directory di Microsoft.NET Framework. Se nel computer sono in esecuzione più versioni di .NET Framework in modalità side-by-side, potrebbero essere installate più versioni dello strumento. Nella tabella seguente sono elencati i percorsi di installazione dello strumento per diverse versioni di .NET Framework.
Versione di .NET Framework |
Percorso del file Aspnet_regbrowsers.exe |
|---|---|
.NET Framework versione 2.0, versione 3.0 e versione 3.5 (sistemi a 32 bit) |
%windir%\Microsoft.NET\Framework\v2.0.50727 |
.NET Framework versione 2.0, versione 3.0 e versione 3.5 (sistemi a 64 bit) |
%windir%\Microsoft.NET\Framework64\v2.0.50727 |
.NET Framework versione 4 (sistemi a 32 bit) |
%windir%\Microsoft.NET\Framework\v4.0.30319 |
.NET Framework versione 4 (sistemi a 64 bit) |
%windir%\Microsoft.NET\Framework64\v4.0.30319 |
Vedere anche
Attività
Procedura: rilevare i tipi di browser e le relative funzionalità nelle pagine Web ASP.NET
Riferimenti
Schema del file di definizione del browser (elemento browsers)