clientTarget Element (ASP.NET Settings Schema)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework General Reference

clientTarget Element (ASP.NET Settings Schema)

Updated: November 2007

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

<configuration> Element
system.web Element (ASP.NET Settings Schema)
clientTarget Element (ASP.NET Settings Schema)

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

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 SystemWebSectionGroup..::.ClientTarget 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

Product Families

Resources

About Microsoft

Popular Places

Popular Searches

Popular Downloads

Attributes

Child Elements

Parent Elements

Default Configuration

Tasks

Concepts

Reference

Other Resources