asp.net.ph

Skip Navigation Links

<clientTarget> Section

ASP.NET Syntax   ASP.NET Configuration Sections


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

<clientTarget>

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

</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>
See Also

ASP.NET Configuration   ClientTargetSection Class



© 2025 Reynald Nuñez and asp.net.ph. All rights reserved.

If you have any question, comment or suggestion
about this site, please send us a note