Elemento clientTarget (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Consente di aggiungere alias di agenti utenti specifici a un insieme interno di alias di agenti utenti.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento clientTarget (schema delle impostazioni ASP.NET)

<clientTarget> 
   <add... />
   <remove... />
   <clear/>
</clientTarget>

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
add	Elemento facoltativo. Consente di aggiungere l'alias di un agente utente specifico a un insieme interno di alias di agenti utenti.
clear	Elemento facoltativo. Rimuove tutti gli alias ereditati dal file Web.config specificato o in esso contenuti.
remove	Elemento facoltativo. Rimuove l'alias di un agente utente specifico da un insieme interno di alias di agenti utenti. Il valore deve corrispondere esattamente a quello di una precedente direttiva add. Non è supportato l'utilizzo di selezioni con caratteri jolly.

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	Consente di specificare l'elemento radice per la sezione di configurazione ASP.NET.

Note

L'insieme degli alias degli agenti utenti indica gli agenti utenti di destinazione per cui i controlli server ASP.NET devono eseguire il rendering del contenuto.

Configurazione predefinita

L'elemento clientTarget predefinito riportato di seguito è configurato nel file Web.config a livello di radice in .NET Framework versione 2.0.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0" />
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0" />
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.1)" />
     <add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>

Nel file Machine.config in .NET Framework versioni 1.0 e 1.1 viene configurato l'elemento clientTarget predefinito riportato di seguito.

<clientTarget>
     <add alias="ie5" userAgent="Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 4.0)"/>
     <add alias="ie4" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="uplevel" userAgent="Mozilla/4.0 (compatible; MSIE 4.0; Windows NT 4.0)"/>
     <add alias="downlevel" userAgent="Unknown"/>
</clientTarget>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere quattro alias di agenti utenti.

<configuration>
   <system.web>
      <clientTarget>
         <add alias="ie5" userAgent="Mozilla/4.0 (compatible;MSIE 5.5;Windows NT 4.0)"/>
         <add alias="ie4" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="uplevel" userAgent="Mozilla/4.0 (compatible;MSIE 4.0;Windows NT 4.0)"/>
         <add alias="downlevel" userAgent="Unknown"/>
      </clientTarget>
   </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione	System.Web.Configuration.ClientTargetSection
Membro di configurazione	System.Web.Configuration.ClientTarget SystemWebSectionGroup.ClientTarget Page.ClientTarget
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 1.0, 1.1 o 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Cenni preliminari sulla configurazione di ASP.NET

Controlli server Web ASP.NET e funzionalità del browser

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

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

Elemento configuration (schema delle impostazioni generali)

Elemento add per clientTarget (schema delle impostazioni ASP.NET)

Elemento clear per clientTarget (schema delle impostazioni ASP.NET)

Elemento remove per clientTarget (schema delle impostazioni ASP.NET)

@ Page

System.Configuration

System.Web.Configuration

Altre risorse

File di configurazione ASP.NET

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

API di configurazione di ASP.NET