Elemento browserCaps (schema delle impostazioni ASP.NET)

Articolo
08/11/2011

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 obsoleto 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).

L'utilizzo dell'elemento browserCaps nel file Web.config per definire i browser risulta obsoleto 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 illustrati attributi, elementi figlio e 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".

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.

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 obsoleto 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	HttpCapabilitiesSectionHandler
Membro di configurazione	Browsers
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 (obsoleto), 1.1 o 1.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite

Elemento browserCaps (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Riferimenti

Concetti

Altre risorse

Risorse aggiuntive