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

更新:2007 年 11 月

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

<configuration> 元素
  system.web 元素(ASP.NET 设置架构)
    clientTarget 元素(ASP.NET 设置架构)

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

属性和元素

下面几部分描述了属性、子元素和父元素。

属性

无。

子元素

元素

说明

add

可选的元素。

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

clear

可选的元素。

移除当前在指定 Web.config 文件中包含的或从该指定文件继承的所有别名。

remove

可选的元素。

从用户代理别名的内部集合中移除特定用户代理的别名。该值必须与上一个 add 指令的值完全匹配。不支持通配符选择。

父元素

元素

说明

configuration

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

system.web

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

备注

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

默认配置

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

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

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

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

示例

下面的代码示例演示如何添加四个用户代理别名。

<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

配置成员

System.Web.Configuration.ClientTarget

SystemWebSectionGroup.ClientTarget

Page.ClientTarget

可配置的位置

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 配置设置

概念

ASP.NET 配置概述

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

保证 ASP.NET 配置的安全

ASP.NET 配置方案

参考

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

configuration 元素(常规设置架构)

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

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

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

@ Page

System.Configuration

System.Web.Configuration

其他资源

ASP.NET 配置文件

ASP.NET 配置设置

常规配置设置 (ASP.NET)

ASP.NET 配置 API