Strumento di registrazione del browser ASP.NET (Aspnet_regbrowsers.exe)
Aggiornamento: novembre 2007
Lo strumento di registrazione del browser ASP.NET 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 e si trova nella directory %SystemRoot%\Microsoft.NET\Framework\versione\.
In ASP.NET versione 1.1 il file Machine.config contiene una sezione denominata <browserCaps>, nella quale sono presenti alcune voci XML che definiscono le configurazioni dei diversi browser sulla base di un'espressione regolare. Nella versione 2.0 di ASP.NET un nuovo file BROWSER definisce i parametri di un determinato browser mediante voci XML. Per aggiungere informazioni su un nuovo browser, è possibile aggiungere un nuovo file BROWSER alla cartella di sistema %SystemRoot%\Microsoft.NET\Framework\versione\CONFIG\Browsers.
Dal momento che non viene eseguita la lettura di un file config a ogni richiesta di informazioni sul browser, è possibile creare un nuovo file BROWSER ed eseguire Aspnet_regbrowsers.exe per aggiungere le modifiche necessarie all'assembly. In questo modo sul server è possibile accedere alle nuove informazioni relative al browser immediatamente senza che sia necessario chiudere le applicazioni in uso per raccogliere le informazioni. L'accesso alle funzionalità browser da parte di un'applicazione è consentito dalla proprietà Browser dell'oggetto HttpRequest corrente.
Sintassi
aspnet_regbrowsers.exe <options>
Opzioni
Opzione |
Descrizione |
|---|---|
-? |
Consente di visualizzare il testo della Guida in linea 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 sono contenuti nella directory %SystemRoot%\Microsoft.NET\Framework\versione\CONFIG\Browsers. Questa directory contiene i file di definizione del browser predefiniti forniti con la versione corrispondente di .NET e altri file di questo tipo aggiuntivi copiati in tale posizione dagli aggiornamenti del software o dai service pack. Non modificare i file di definizione del browser predefiniti forniti con 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. In entrambe le directory i file di definizione del browser devono avere l'estensione BROWSER. 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 Browsers della versione di .NET Framework corrispondente alla versione dello strumento stesso. Ogni versione di .NET Framework è dotata di una copia specifica dello strumento.
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, i dati contenuti nei file di 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
L'utilizzo dell'elemento <browserCaps> nel file Web.config per definire i browser risulta obsoleto in .NET Framework versione 2.0, anche se è supportato. 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 invece analizzati automaticamente e compilati a richiesta quando viene avviata l'applicazione. Eventuali modifiche alla directory Browsers dell'applicazione causano la ricompilazione dell'applicazione stessa. 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 Aspnet_regbrowsers.exe. Per creare e installare l'assembly, utilizzare il comando seguente:
C:\WINDOWS\Microsoft.NET\Framework\<versionNumber>\aspnet_regsql.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_regsql.exe -u
Per visualizzare le informazioni della Guida in linea sull'utilizzo dello strumento di registrazione del browser ASP.NET, utilizzare il comando seguente:
aspnet_regsql.exe -?
Vedere anche
Attività
Procedura: rilevare tipi di browser in pagine Web ASP.NET
Concetti
Controlli server Web ASP.NET e funzionalità del browser
Protezione di file di definizione del browser
Riferimenti
Schema del file di definizione del browser (elemento browsers)