add Element for clientTarget (ASP.NET Settings Schema)
Adds an alias for a specific user agent to an internal collection of user agent aliases.
<add alias="alias for user agent"
userAgent="user agent identification"/>
The following sections describe attributes, child elements, and parent elements.
Attributes
| Attribute | Description |
|---|---|
| alias | Required attribute. Specifies the name that is used to refer to a specific user agent. |
| userAgent | Required attribute. Specifies the identification for the user agent. |
Child Elements
None.
Parent Elements
| Element | Description |
|---|---|
| configuration | Specifies the 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. |
| clientTarget | Adds aliases for specific user agents to an internal collection of user agent aliases. |
The collection of user agent aliases indicates the target user agents that ASP.NET server controls should render content for.
The following default add element is configured in the root Web.config file in the .NET Framework version 2.0.
<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" />
The following default add element is configured in the Machine.config file in the .NET Framework versions 1.0 and 1.1.
<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"/>
The following code example demonstrates how to add four user agent aliases to the internal user agent alias collection.
<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 | |
| Configuration member | |
| 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 |
Tasks
How to: Lock ASP.NET Configuration SettingsReference
clientTarget Element (ASP.NET Settings Schema)system.web Element (ASP.NET Settings Schema)
configuration Element (General 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 OverviewASP.NET Web Server Controls and Browser Capabilities
Securing ASP.NET Configuration
ASP.NET Configuration Scenarios
Other Resources
ASP.NET Configuration FilesASP.NET Configuration Settings
General Configuration Settings (ASP.NET)
ASP.NET Configuration API