Elemento browserCaps (schema delle impostazioni ASP.NET)
[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]
Specifica le impostazioni dei browser supportati e le relative funzionalità. È possibile aggiornare l'elemento browserCaps come richiesto per specificare i nuovi browser e le relative funzionalità.
Nota
L'utilizzo dell'elemento browserCaps nel file Web.config per definire i browser risulta deprecato in .NET Framework 2.0, anche se è supportato.I dati di questo elemento vengono uniti alle informazioni contenute nei file di definizione del browser (con estensione BROWSER) che si trovano nella cartella %SystemRoot%\Microsoft.NET\Framework\versione\CONFIG\Browsers a livello di computer e in tutte le cartelle App_Browser a livello di applicazione esistenti.Per ulteriori informazioni, vedere Schema del file di definizione del browser (elemento browsers).
<browserCaps>
<result />
<use />
[browser capability property assignments]
<filter>...</filter>
</browserCaps>
Attributi ed elementi
Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.
Attributi
Attributo |
Descrizione |
|---|---|
userAgentCacheKeyLength |
Attributo String facoltativo. Specifica la lunghezza della stringa di identificazione del browser da utilizzare come chiave per la memorizzazione nella cache interna degli oggetti delle funzionalità del browser. Per ulteriori informazioni sull'aggiunta di oggetti delle funzionalità del browser, vedere Schema del file di definizione del browser (elemento browsers). Questo attributo è nuovo in .NET Framework versione 2.0. Il valore predefinito è "64". |
Elementi figlio
Elemento |
Descrizione |
|---|---|
filter |
Elemento facoltativo. Specifica un elenco di stringhe di ricerca che consentono di applicare singole impostazioni a definizioni specifiche del browser. |
result |
Specifica la classe derivata da HttpCapabilitiesBase utilizzata per contenere i risultati dell'analisi della sezione browserCaps. Le funzionalità vengono archiviate come coppie di stringhe chiave/valore per ogni browser. Questo elemento viene ancora applicato in .NET Framework versione 2.0. |
use |
Specifica la stringa di richiesta HTTP utilizzata per analizzare le informazioni relative alle funzionalità del browser memorizzate negli elementi filter e case. |
Elementi padre
Elemento |
Descrizione |
|---|---|
configuration |
Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework. |
system.web |
Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione e contiene gli elementi che consentono di configurare le applicazioni Web ASP.NET e di controllarne il comportamento. |
Note
L'elemento browserCaps specifica le impostazioni dei browser supportati e le relative funzionalità. È possibile aggiornare l'elemento browserCaps come richiesto per specificare i nuovi browser e le relative funzionalità.
Per un elenco di proprietà browser valide, vedere HttpBrowserCapabilities.
Le righe di tipo capsVariableName=espressione regolare sono assegnazioni. Utilizzare la sintassi %{capsVariableName} o ${captureGroupName} negli attributi match e a destra delle assegnazioni.
Per ulteriori informazioni sull'utilizzo delle espressioni regolari, vedere Espressioni regolari di .NET Framework. Per esaminare la sezione browserCaps completa, con un esempio 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 della classe HttpBrowserCapabilities ereditata dalla classe HttpCapabilitiesBase. Item è la proprietà dell'indicizzatore predefinita in C#.
Configurazione predefinita
In .NET Framework versione 2.0 l'elemento limitato browserCaps predefinito riportato di seguito non viene configurato nel file Web.config radice in quanto è classificato come deprecato a favore dell'utilizzo dei file di definizione del browser per specificare i browser supportati e le relative funzionalità. Per ulteriori informazioni, vedere Schema del file di definizione del browser (elemento browsers).
<browserCaps userAgentCacheKeyLength="64">
<result
type="System.Web.Mobile.MobileCapabilities, System.Web.Mobile, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
/>
</browserCaps>
In .NET Framework versioni 1.0 e 1.1 l'elemento browserCaps predefinito, configurato nel file machine.config, è troppo grande per essere elencato in questa sede. Per gli aggiornamenti dei dati del browser, visitare il sito http://www.cyscape.com/browsercaps (informazioni in lingua inglese). Gli aggiornamenti periodici per i dispositivi sostituiscono questa sezione delle funzionalità del browser.
Esempio
Nell'esempio di codice che segue viene illustrato come analizzare l'intestazione HTTP User-Agent per qualsiasi versione di Microsoft 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 HttpBrowserCapabilities.
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>
<system.web>
<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>
</system.web>
</configuration>
Informazioni sull'elemento
Gestore della sezione di configurazione |
|
Membro di configurazione |
|
Percorsi configurabili |
Machine.config Web.config a livello di radice Web.config a livello di applicazione Web.config a livello di directory fisica o virtuale |
Requisiti |
Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 .NET Framework versione 2.0 (deprecato), 1.1 o 1.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vedere anche
Attività
How to: Detect Browser Types in ASP.NET Web Pages
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Riferimenti
Elemento system.web (schema delle impostazioni ASP.NET)
Elemento configuration (schema delle impostazioni generali)
Elemento filter per browserCaps (schema delle impostazioni ASP.NET)
Elemento result per browserCaps (schema delle impostazioni ASP.NET)
Elemento use per browserCaps (schema delle impostazioni ASP.NET)
Schema del file di definizione del browser (elemento browsers)
HttpCapabilitiesSectionHandler
Concetti
ASP.NET Server Controls and Browser Capabilities
ASP.NET Configuration File Hierarchy
Altre risorse
Impostazioni di configurazione generali (ASP.NET)
Impostazioni di configurazione di ASP.NET