Schema del file di definizione del browser (elemento browsers)

Aggiornamento: novembre 2007

I file di definizione del browser contengono le definizioni per i singoli browser. In fase di esecuzione ASP.NET utilizza le informazioni nell'intestazione della richiesta per determinare quale tipo di browser ha effettuato la richiesta. Utilizza quindi i file con estensione browser per determinare le funzionalità del browser e la modalità di rendering del codice in tale browser. Questa funzione è utile per gli sviluppatori Web che desiderano creare applicazioni da visualizzare su dispositivi mobili, utilizzando gli adattatori di controllo che adattano il comportamento di un controllo server Web ASP.NET a seconda del tipo di dispositivo. Per ulteriori informazioni, vedere i collegamenti nella sezione Vedere anche.

Per l'elemento browsers viene utilizzata la struttura seguente.

<browsers>
    <browser id="browser name"
             parentID="parent browser name"
             refID="reference ID">
        <identification>
            <userAgent match="regular expression"
                       nonMatch="regular expression" />
            <header match="regular expression"
                    name="header name"
                    nonMatch="regular expression" />
            <capability match="regular expression"
                        name="capability name"
                        nonMatch="regular expression" />
        </identification>
        <capture>
            <userAgent match="regular expression" />
            <header match="regular expression"
                    name="header name" />
            <capability match="regular expression"
                        name="capability name" />
        </capture>
        <capabilities>
            <capability name="capability name"
                        value="capability value" />
        </capabilities>
        <controlAdapters markupTextWriterType="type name">
            <adapter adapterType="name of adapter class"
                     controlType="name of control class" />
        </controlAdapters>
        <sampleHeaders>
            <header name="header name"
                    value="header value" />
        </sampleHeaders>
    </browser>
    <gateway id="gateway ID"
             parentID="parent browser ID">
        <!-- Same child elements as for <browser>.
        <identification></identification>
        <capture></capture>
        <capabilities></capabilities>
        <controlAdapters></controlAdapters>
        <sampleHeaders></sampleHeaders>
         -->
    </gateway>
    <defaultBrowser id="Default" 
                    parentID="parent browser ID"
                    refID="reference ID" >
        <!-- Same child elements as for <browser>.
        <identification></identification>
        <capture></capture>
        <capabilities></capabilities>
        <controlAdapters></controlAdapters>
        <sampleHeaders></sampleHeaders>
         -->
    </defaultBrowser>
</browsers>

Attributi ed elementi

    <controlAdapters markupTextWriterType="System.Web.UI.XhtmlTextWriter" >
        <adapter
          controlType="System.Web.UI.WebControls.Menu"
          adapterType="System.Web.UI.WebControls.Adapters.MenuAdapter">
        </adapter>
    </controlAdapters>

<browser refID="IE">
    <capabilities>
        <capability name="UseRichTextBox" value="true" />
    </capabilities>
    <controlAdapters>
        <adapter controlType="System.Web.UI.Calendar"
adapterType="ExampleAdapters.ExampleIECalendarAdapter"
        />
    </controlAdapters>
</browser>

    <capabilities>
        <capability name="browser"          value="IE" />
        <capability name="extra"            value="${extra}" />
        <capability name="isColor"          value="true" />
        <capability name="letters"          value="${letters}" />
        <capability name="majorversion"     value="${major}" />
        <capability name="minorversion"     value="${minor}" />
        <capability name="screenBitDepth"   value="8" />
        <capability name="type"             value="IE${major}" />
        <capability name="version"          value="${version}" />
    </capabilities>

    <browser id="IE5to9" parentID="IE">
        <identification>
            <capability name="majorversion" match="^[5-9]" />
        </identification>
        <!-- Capability elements. -->
    </browser>

    <capture>
        <userAgent match="PalmSource; Blazer 3\.0\)\s\d+;(?'screenPixelsHeight'\d+)x(?'screenPixelsWidth'\d+)$" />
    </capture>

    <capture>
        <header name="HTTP_X_UP_DEVCAP_NUMSOFTKEYS" 
                match="(?'softkeys'\d+)" />
    </capture>

    <defaultBrowser id="Default">
        <capabilities>
            <capability name="ecmascriptversion"   value="0.0" />
            <capability name="javascript"          value="false" />
            <capability name="jscriptversion"      value="0.0" />
        </capabilities>
    </defaultBrowser>

    <gateway id="IE3AK" parentID="IE3">
        <identification>
            <capability name="extra" match="; AK;" />
        </identification>
        <capture>
        </capture>
        <capabilities>
            <capability name="ak"  value="true" />
        </capabilities>
    </gateway>

<identification>
    <header name="Accept" 
            match="text/vnd\.wap\.wml|text/hdml" />
    <header name="Accept" 
            nonMatch="application/xhtml\+xml; profile|application/vnd\.wap\.xhtml\+xml" />
</identification>

        <identification>
            <userAgent match="MSIE 4" />
        </identification>

Note

Se nessuno dei file di definizione del browser esistenti soddisfa i criteri specificati, è possibile creare nuovi file utilizzando il codice riportato nella sezione Esempio seguente.

Nota sulla sicurezza:
Non scaricare né installare file di definizione del browser da terze parti a meno che la fonte non sia considerata attendibile. Esaminare un nuovo file di definizione del browser per verificare se viene fatto riferimento a spazi dei nomi non riconosciuti. Per ulteriori informazioni, vedere Protezione di file di definizione del browser.

I file di definizione del browser predefiniti sono memorizzati nella directory %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers. I file di definizione del browser a livello di 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. Non modificare i file di definizione del browser forniti con ASP.NET, perché questi file potrebbero essere aggiornati dai service pack, sovrascrivendo le modifiche. Creare invece nuovi file con estensione browser e utilizzare l'attributo parentID in una nuova definizione di browser per ereditare le impostazioni oppure l'attributo refID per aggiungere funzionalità a una definizione esistente.

In fase di esecuzione le informazioni del file di definizione del browser vengono unite in un insieme di browser noti 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. Questa operazione viene eseguita iniziando da un dizionario vuoto e applicando i seguenti passaggi ricorsivi nella struttura di definizione del browser:

1. Iniziare dalla definizione del browser predefinita, che viene sempre considerata una corrispondenza corretta.

2. Unire i valori delle funzionalità specificati in questa definizione nel dizionario di funzionalità relativo al browser. I valori specificati in una definizione del browser eseguono l'override di quelli impostati in un oggetto padre.

3. Valutare ogni definizione figlio per determinare una corrispondenza. Per ogni elemento figlio corrispondente, iniziare nuovamente dal passaggio 1. Le definizioni del browser vengono valutate dopo quelle del gateway. Se l'agente utente corrisponde a più di una definizione del browser o a più di una definizione del gateway, in fase di esecuzione verrà generata un'eccezione.

L'oggetto HttpBrowserCapabilities viene memorizzato nella cache e potrebbe essere utilizzato di nuovo per una richiesta differente dello stesso tipo di browser.

Un'applicazione Web può accedere all'istanza corrente dell'oggetto HttpBrowserCapabilities utilizzando la proprietà HttpRequest.Browser. L'oggetto è in sola lettura è contiene le proprietà di ogni funzionalità. In alternativa uno sviluppatore Web può costruire una classe personalizzata che eredita dalla classe HttpBrowserCapabilities e memorizzare un'istanza nella proprietà HttpRequest.Browser.

Le modifiche apportate ai file con estensione browser situati nella directory App_Browsers invalidano la cache e con la richiesta successiva l'applicazione verrà ricompilata. Se tuttavia le modifiche vengono apportate nei file con estensione browser nella directory %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers, è necessario ricompilare l'applicazione manualmente utilizzando lo strumento %SystemRoot%\Microsoft.NET\Framework\version\aspnet_regbrowsers.exe oppure a livello di codice utilizzando la classe BrowserCapabilitiesCodeGenerator.

Quando un browser effettua una richiesta all'applicazione, le relative funzionalità vengono memorizzate nella proprietà Browser. L'identità del browser viene memorizzata nella proprietà UserAgent. I controlli server Web ASP.NET effettuano una query nell'elenco di funzionalità per definire come adattare il comportamento dei controlli in modo appropriato per browser differenti.

Funzionalità

Per un elenco di funzionalità di browser fortemente tipizzate, vedere le proprietà della classe HttpCapabilitiesBase. Queste proprietà utilizzano la convenzione Camel nei file di definizione del browser. Se ad esempio si desidera specificare la funzionalità BackgroundSounds nel file di definizione del browser, digitarla nel formato backgroundSounds.

È inoltre possibile definire funzionalità personalizzate.

Un'applicazione Web può recuperare i valori delle funzionalità dall'oggetto HttpBrowserCapabilities in uno dei due modi seguenti:

• Mediante l'accesso al dizionario delle funzionalità. È possibile utilizzare questo metodo per le funzionalità personalizzate.

  Per ottenere ad esempio il valore della funzionalità ECMAScript (JavaScript) per il browser del client corrente, è possibile utilizzare il seguente codice:

  String cap_javascript = Request.Browser["javascript"];
  

• Mediante una chiamata a una proprietà fortemente tipizzata che incapsula una funzionalità.

  Per ottenere ad esempio il valore della funzionalità ECMAScript per il browser del client corrente, è possibile utilizzare il seguente codice:

  String cap_javascript = Request.JavaScript;
  

Configurazione predefinita

Con .NET Framework vengono forniti i file di definizione del browser predefiniti nella directory %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers. È possibile creare file di definizione del browser a livello di applicazione nella directory App_Browsers dell'applicazione. Per informazioni sulle directory speciali di ASP.NET, vedere Layout del sito Web ASP.NET.

L'esempio di codice riportato di seguito è tratto dal file Generic.browser nella directory %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers.

<browsers>
    <browser id="GenericDownlevel" parentID="Default">
        <identification>
            <userAgent match="^Generic Downlevel$" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="cookies"                     value="false" />
            <capability name="ecmascriptversion"           value="1.0" />
            <capability name="tables"                      value="true" />
            <capability name="type"                        value="Downlevel" />
        </capabilities>
        <controlAdapters>
            <adapter controlType="System.Web.UI.WebControls.Menu"
            adapterType="System.Web.UI.WebControls.Adapters.MenuAdapter" />
        </controlAdapters>
    </browser>
</browsers>

L'esempio di codice riportato di seguito è tratto dal file WebTV.browser nella directory %SystemRoot%\Microsoft.NET\Framework\version\CONFIG\Browsers.

<browsers>
    <browser id="WebTV" parentID="IE2">
        <identification>
            <userAgent match="WebTV/(?'version'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="backgroundsounds"    value="true" />
            <capability name="browser"             value="WebTV" />
            <capability name="cookies"             value="true" />
            <capability name="isMobileDevice"      value="true" />
            <capability name="letters"             value="${letters}" />
            <capability name="majorversion"        value="${major}" />
            <capability name="minorversion"        value="${minor}" />
            <capability name="tables"              value="true" />
            <capability name="type"                value="WebTV${major}" />
            <capability name="version"             value="${version}" />
        </capabilities>

        <controlAdapters markupTextWriterType="System.Web.UI.Html32TextWriter">
        </controlAdapters>
    </browser>

    <browser id="WebTV2" parentID="WebTV">
        <identification>
            <capability name="minorversion" match="2" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="css1"                value="true" />
            <capability name="ecmascriptversion"   value="1.0" />
            <capability name="javascript"          value="true" />
        </capabilities>
    </browser>

    <gateway id="WebTVbeta" parentID="WebTV">
        <identification>
            <capability name="letters" match="^b" />
        </identification>

        <capture>
        </capture>

        <capabilities>
            <capability name="beta"    value="true" />
        </capabilities>
    </gateway>
</browsers>

Esempio

L'esempio di codice riportato di seguito è un file con estensione browser vuoto che è possibile utilizzare come base. Prestare attenzione a non creare riferimenti circolari nei file browser.

<?xml version="1.0" encoding="utf-8"?>

<browsers>
    <browser id="NewBrowser" parentID="Mozilla">
        <identification>
            <userAgent match="Unique User Agent Regular Expression" />
        </identification>

        <capture>
            <userAgent match="NewBrowser (?'version'\d+\.\d+)" />
        </capture>

        <capabilities>
            <capability name="browser" value="My New Browser" />
            <capability name="version" value="${version}" />
        </capabilities>
    </browser>

    <browser refID="Mozilla">
        <capabilities>
            <capability name="xml" value="true" />
        </capabilities>
    </browser>
</browsers>

Informazioni sull'elemento

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

Scenari di configurazione ASP.NET

Cenni preliminari sul filtro di periferica ASP.NET

Cenni preliminari sull'architettura del comportamento adattivo di un controllo

Cenni preliminari sullo sviluppo di pagine Web mobili ASP.NET

Riferimenti

Browsers

Capabilities

HttpCapabilitiesSectionHandler

HttpBrowserCapabilities

Elemento deviceFilters (schema delle impostazioni ASP.NET)

Elemento mobileControls (schema delle impostazioni ASP.NET)

Elemento browserCaps (schema delle impostazioni ASP.NET)

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET