clientTarget Element (ASP.NET Settings Schema)
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. |
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. For more information, see the Page.ClientTarget property.
Default Configuration
The following default clientTarget element is configured in the root Web.config file.
<clientTarget>
<add alias="uplevel" userAgent="Mozilla/5.0 (compatible; MSIE 6.0; Windows NT 5.1)" />
<add alias="downlevel" userAgent="Generic Downlevel" />
</clientTarget>
Example
The following code example demonstrates how to add 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)"/>
</clientTarget>
</system.web>
</configuration>
Element Information
Configuration section handler |
|
Configuration member |
System.Web.Configuration.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 or a later version The .NET Framework version 1.0 or a later version Microsoft Visual Studio 2003 or a later version |
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)
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 Settings