Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

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>

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.

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

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>

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>

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft