Elemento filter per browserCaps (schema delle impostazioni ASP.NET)

Articolo
05/27/2012

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Questo elemento specifica un elenco di stringhe di ricerca che consentono di applicare singole impostazioni a definizioni specifiche del browser.

Nota

L'utilizzo dell'elemento browserCaps nel file Web.config per definire i browser risulta deprecato in .NET Framework versione 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).

<filter> 
   [assignments, filter elements and case elements]
<filter>
<filter 
   match="[regular expression]" 
   with="[regular expression]" >
   [browser capability assignments, filter elements, case elements]
</filter>
<filter>
   <case>...</case>
</filter>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
match	Attributo String facoltativo. Specifica un'espressione regolare di .NET Framework sottoposta a test sulla base dell'attributo with. Se omesso, la corrispondenza verrà considerata valida.
with	Attributo String facoltativo. Specifica una stringa o un'espressione regolare di .NET Framework da ricercare. Se omesso, viene utilizzata la stringa specificata dall'elemento use.

match

Attributo String facoltativo.

Specifica un'espressione regolare di .NET Framework sottoposta a test sulla base dell'attributo with. Se omesso, la corrispondenza verrà considerata valida.

with

Attributo String facoltativo.

Specifica una stringa o un'espressione regolare di .NET Framework da ricercare. Se omesso, viene utilizzata la stringa specificata dall'elemento use.

Elementi figlio

Elemento	Descrizione
case	Consente l'interruzione dei criteri di ricerca dopo l'elaborazione della prima corrispondenza riuscita tra diverse alternative.

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

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.

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.

Note

L'elemento browserCaps specifica un elenco di stringhe di ricerca che consentono di applicare singole impostazioni a definizioni specifiche del browser. Le regole contenute nell'elenco vengono applicate in sequenza. Il primo elemento case figlio che corrisponde viene valutato mentre gli altri elementi case figlio vengono ignorati.

Configurazione predefinita

In .NET Framework versione 2.0 l'elemento filter non viene configurato in quanto l'elemento browserCaps è 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).

In .NET Framework versioni 1.0 e 1.1 gli elementi filter predefiniti, configurati nel file machine.config, sono troppo grandi per essere elencati 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'elemento 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>

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 (deprecato), 1.0 o 1.1 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Elemento filter per 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