Condividi tramite


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

Aggiornamento: novembre 2007

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

Elemento configuration (schema delle impostazioni generali)
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento browserCaps (schema delle impostazioni ASP.NET)
      Elemento filter per browserCaps (schema delle impostazioni ASP.NET)

<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

Le seguenti sezioni illustrano attributi, elementi figlio e 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.

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.

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

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 (obsoleto), 1.0 o 1.1

Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

Procedura: rilevare tipi di browser in pagine Web ASP.NET

Procedura: configurare directory specifiche utilizzando le impostazioni posizione

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Controlli server Web ASP.NET e funzionalità del browser

Gerarchia ed ereditarietà dei file di configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

Elemento browserCaps (schema delle impostazioni ASP.NET)

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

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

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)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

API di configurazione di ASP.NET