Condividi tramite


Elemento <browserCaps>

Consente di controllare le impostazioni del componente delle funzioni. L'elemento <browserCaps> può essere dichiarato a livello di sottodirectory, applicazione, sito o computer. Può essere aggiornato come richiesto, per rilevare i futuri browser e le future funzioni browser.

Per un elenco delle proprietà browser valide, fare riferimento alla classe HttpBrowserCapabilities.

<configuration>
   <system.web>
**      <browserCaps>**

<browserCaps>
   <result type="class"/>   <use var="HTTP_USER_AGENT"/>        browser=Unknown
        version=0.0
        majorver=0
        minorver=0
        frames=false
        tables=false
      <filter>         <case match="Windows 98|Win98">
            platform=Win98
         </case>      <case match="Windows NT|WinNT">
         platform=WinNT
      </case>   </filter>   <filter match="Unknown" with="%(browser)">
      <filter match="Win95" with="%(platform)">
      </filter>   </filter></browserCaps>

Sottotag

Sottotag Descrizione
<use> Consente di specificare le variabili server utilizzate durante la valutazione di <filter>, <case> e le assegnazioni della sezione.
<filter> Consente di valutare il primo elemento figlio <case> che corrisponde al criterio indicato; tutti gli altri elementi vengono ignorati.
<result> Consente di specificare la classe derivata da HttpCapabilitiesBase utilizzata per impedire l'analisi della sezione da parte delle coppie di stringhe chiave/valore risultanti, ad esempio browser, version e majorver nel blocco di codice sopra riportato. Questa stringa viene utilizzata in fase di esecuzione per creare il tipo restituito.

Osservazioni

Le righe di tipo capsVariableName=regular expression sono assegnazioni. Utilizzare la sintassi %{capsVariableName} o ${captureGroupName} negli attributi match e sul lato destro delle assegnazioni. Per ulteriori informazioni sull'uso di espressioni regolari, vedere Espressioni regolari di .NET Framework. Per esaminare la sezione <browserCaps> completa, con un esempio più esaustivo di questa sintassi, fare riferimento al file Machine.config installato con .NET Framework.

Le coppie nome/valore acquisite con capsVariableName sono accessibili tramite la proprietà Item di HttpBrowserCapabilities ereditata da HttpCapabilitiesBase. Item è la proprietà dell'indicizzatore predefinita in C#.

Esempio

Nell'esempio che segue viene illustrata l'analisi dell'intestazione HTTP User-Agent per qualsiasi versione di Internet Explorer (nella misura in cui il formato della stringa User-Agent resta quasi del tutto invariato).

Nell'esempio vengono utilizzate le espressioni regolari di .NET Framework e la relativa funzionalità di acquisizione di espressioni secondarie per spostare i numeri di versione direttamente dalla stringa User-Agent all'oggetto browserCaps.

Nel file le coppie nome/valore vengono specificate sotto forma di istruzioni di assegnazione, in modo analogo a quanto accade nei file browscap.ini di Microsoft Internet Information Services (IIS). La riga "browser=IE" imposta, ad esempio, il valore del campo browser sulla stringa "IE".

<configuration>
   <browserCaps>
      <result type="System.Web.HttpBrowserCapabilities, System.Web"/>
      <use var="HTTP_USER_AGENT"/>
      browser=Unknown
      version=0.0
      majorversion=0
      minorversion=0
      frames=false
      tables=false
      cookies=false
      backgroundsounds=false
      <filter>
         <case match="^Mozilla[^(]*\(compatible; MSIE 
            (?'ver'(?'major'\d+)(?'minor'\.\d+)(?'letters'\w*))
            (?'extra'.*)">
            browser=IE
            version=${ver}
            majorver=${major}
            minorver=${minor}
            <case match="^2\." with="%{version}">
               tables=true
               cookies=true
               backgroundsounds=true
               <case match="2\.5b" with="%{version}">
                  beta=true
               </case>
            </case>
         </case>
      </filter>
   </browsercaps>
</configuration>

Requisiti

Contenuto in: <system.web>

Piattaforma Web: IIS 5.0, IIS 5.1, IIS 6.0

File di configurazione: Machine.config, Web.config

Gestore della sezione di configurazione: System.Web.Configuration.HttpCapabilitiesSectionHandler

Vedere anche

Configurazione ASP.NET | Schema delle impostazioni ASP.NET