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

Articolo
09/12/2008

Aggiornamento: novembre 2007

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

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

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)
        Elemento case per filter per browserCaps (schema delle impostazioni ASP.NET)

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
match	Attributo String obbligatorio. 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 obbligatorio. Specifica la stringa o l'espressione regolare di .NET Framework da ricercare. Se omesso, viene utilizzata la stringa specificata dall'elemento use.

match

Attributo String obbligatorio.

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

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

Elementi figlio

Nessuno.

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.
filter	Specifica un elenco di stringhe di ricerca che consentono di applicare singole impostazioni a definizioni specifiche del browser.

Note

L'elemento case consente l'interruzione dei criteri di ricerca dopo l'elaborazione della prima corrispondenza riuscita tra diverse alternative.

Tutti gli elementi filter e case possono contenere assegnazioni e altri elementi filter e case. La differenza tra i gruppi case e filter consiste nel fatto che al termine della valutazione di un gruppo filter, l'esecuzione continua con l'istruzione che segue il gruppo, mentre dopo la valutazione e l'individuazione di una corrispondenza per il gruppo case, l'esecuzione passa direttamente alla fine del gruppo di inclusione.

Configurazione predefinita

In .NET Framework versione 2.0 l'elemento case 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 case 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.1 o 1.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Condividi tramite

Elemento case per 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à

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive