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

请参见

任务

How to: Lock ASP.NET Configuration Settings

参考

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

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

configuration 元素(常规设置架构)

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

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

@ Page

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

其他资源

ASP.NET Configuration Files

ASP.NET 配置设置

常规配置设置 (ASP.NET)

ASP.NET Configuration API