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

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

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

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

特性和元素

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

特性

无。

子元素

元素

说明

add

可选元素。

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

clear

可选元素。

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

remove

可选元素。

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

父元素

元素

说明

configuration

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

system.web

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

备注

用户代理别名的集合指示 ASP.NET 服务器控件应为其呈现内容的目标用户代理。 有关更多信息,请参见 Page.ClientTarget 属性。

默认配置

下面的默认 clientTarget 元素是在根 Web.config 文件中配置的。

<clientTarget>
  <add alias="uplevel" userAgent="Mozilla/5.0 (compatible; MSIE 6.0; Windows NT 5.1)" />
  <add alias="downlevel" userAgent="Generic Downlevel" />
</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)"/>
    </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 或更高版本

.NET Framework 1.0 或更高版本

Microsoft Visual Studio 2003 或更高版本

请参见

任务

How to: Lock ASP.NET Configuration Settings

参考

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

configuration 元素(常规设置架构)

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

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

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

@ Page

System.Configuration

System.Web.Configuration

Page.ClientTarget

概念

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