clientTarget Element (ASP.NET Settings Schema)

Adds aliases for specific user agents to an internal collection of user agent aliases.

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

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None.

Child Elements

Element	Description
add	Optional element. Adds an alias for a specific user agent to an internal collection of user agent aliases.
clear	Optional element. Removes all aliases that are currently contained in or inherited from the specified Web.config file.
remove	Optional element. Removes an alias for a specific user agent from an internal collection of user agent aliases. The value must exactly match that of a previous add directive. Wildcard selections are not supported.

Parent Elements

Element	Description
configuration	Specifies the required root element in every configuration file that is used by the common language runtime and the .NET Framework applications.
system.web	Specifies the root element for the ASP.NET configuration section.

Remarks

The collection of user agent aliases indicates the target user agents that ASP.NET server controls should render content for.

Default Configuration

The following default clientTarget element is configured in the root Web.config file in the .NET Framework version 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>

The following default clientTarget element is configured in the Machine.config file in the .NET Framework versions 1.0 and 1.1.

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

Example

The following code example demonstrates how to add four user agent aliases.

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

Element Information

Configuration section handler	System.Web.Configuration.ClientTargetSection
Configuration member	System.Web.Configuration.ClientTarget System.Web.Configuration.SystemWebSectionGroup.ClientTarget System.Web.UI.Page.ClientTarget
Configurable locations	Machine.config Root-level Web.config Application-level Web.config Virtual or physical directory–level Web.config
Requirements	Microsoft Internet Information Services (IIS) version 5.0, 5.1, or 6.0 The .NET Framework version 1.0, 1.1, or 2.0 Microsoft Visual Studio 2003 or Visual Studio 2005

See Also

Tasks

How to: Lock ASP.NET Configuration Settings

Reference

system.web Element (ASP.NET Settings Schema)
configuration Element (General Settings Schema)
add Element for clientTarget (ASP.NET Settings Schema)
clear Element for clientTarget (ASP.NET Settings Schema)
remove Element for clientTarget (ASP.NET Settings Schema)
@ Page
System.Configuration
System.Web.Configuration

Concepts

ASP.NET Configuration Overview
ASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios

Other Resources

ASP.NET Configuration Files
ASP.NET Configuration Settings
General Configuration Settings (ASP.NET)
ASP.NET Configuration API