clientTarget 的 add 元素(ASP.NET 设置架构)

将特定用户代理的别名添加到用户代理别名的内部集合中。

<add alias="alias for user agent" 
     userAgent="user agent identification"/>

特性和元素

以下几节描述了属性、子元素和父元素。

特性

特性

说明

alias

必选特性。

指定用于表示特定用户代理的名称。

userAgent

必选特性。

指定用户代理的标识。

子元素

无。

父元素

元素

说明

configuration

指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中的根元素。

system.web

为 ASP.NET 配置节指定根元素。

clientTarget

将特定用户代理的别名添加到用户代理别名的内部集合中。

备注

用户代理别名的集合指示 ASP.NET 服务器控件应为其呈现内容的目标用户代理。

默认配置

下面的默认 add 元素在 .NET Framework 版本 2.0 的根 Web.config 文件中配置。

<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" />

下面的默认 add 元素是在 .NET Framework 1.0 和 1.1 版的 Machine.config 文件中配置的。

<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"/>

示例

下面的代码示例演示如何将四个用户代理别名添加到内部用户代理别名集合中。

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

元素信息

配置节处理程序

System.Web.Configuration.ClientTargetSection

配置成员

Add

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

虚拟或物理目录级别的 Web.config

要求

Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0

.NET Framework 版本 1.0、1.1 或 2.0

Microsoft Visual Studio 2003 或 Visual Studio 2005

请参见

任务

如何:锁定 ASP.NET 配置设置

参考

clientTarget 元素(ASP.NET 设置架构)

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

clientTarget 的 clear 元素(ASP.NET 设置架构)

clientTarget 的 remove 元素(ASP.NET 设置架构)

@ Page

System.Configuration

System.Web.Configuration

概念

ASP.NET 配置概述

ASP.NET Web 服务器控件和浏览器功能

保证 ASP.NET 配置的安全

ASP.NET 配置方案

其他资源

ASP.NET 配置文件

ASP.NET 配置设置

常规配置设置 (ASP.NET)

ASP.NET 配置 API