Elemento use per 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 la stringa di richiesta HTTP utilizzata per analizzare le informazioni relative alle funzionalità del browser memorizzate negli elementi filter e case.

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

<use 
   var="server variable" 
   as="variableName"
/>

Attributi ed elementi

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

Attributi

Attributo

Descrizione

var

Attributo String facoltativo.

Specifica la variabile server Microsoft Internet Information Services (IIS) analizzata per estrarre le informazioni sulle funzionalità del browser.

Il valore predefinito è "HTTP_USER_AGENT".

as

Attributo String facoltativo.

Specifica il nome che è possibile utilizzare per fare riferimento alla variabile server in espressioni regolari successive.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

configuration

È 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 come richiesto per specificare i nuovi browser e le relative funzionalità.

Per un elenco di proprietà browser valide, vedere HttpBrowserCapabilities.

Note

L'elemento use specifica la stringa di richiesta HTTP utilizzata per analizzare le informazioni relative alle funzionalità del browser memorizzate negli elementi filter e case.

Configurazione predefinita

In .NET Framework versione 2.0 l'elemento use 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 use 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 Web di cyScape, Inc. all'indirizzo 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 riportato di seguito viene illustrato come specificare che la variabile server IIS HTTP_USER_AGENT è l'origine delle informazioni relative alle funzionalità del browser.

<use var="HTTP_USER_AGENT">

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

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)

Schema del file di definizione del browser (elemento browsers)

System.Configuration

System.Web.Configuration

HttpCapabilitiesSectionHandler

Browsers

Concetti

ASP.NET Server Controls and Browser Capabilities

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API