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