Page.ClientTarget 属性

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

获取或设置一个值，该值使您得以重写对浏览器功能的自动检测，并指定针对特定的浏览器客户端页的呈现方式。

public:
 property System::String ^ ClientTarget { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
public string ClientTarget { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.ClientTarget : string with get, set

Public Property ClientTarget As String

属性值

String

String，指定要重写的浏览器功能。

属性

BrowsableAttribute

示例

下面的代码示例定义了一个 ie302 别名，并包括在其 Web.config 文件中配置应用程序所需的部分。 使用此别名，可以将 属性设置为 ClientTargetie302 ，并专门为 Internet Explorer 3.02 浏览器自定义页面。

<configuration>  
  <system.web>  
   <clientTarget>  
    <add alias="ie302" useragent="Mozilla/2.0 (compatible; MSIE 3.02; Windows NT 3.5)" />  
   </clientTarget>  
  </system.web>  
</configuration>  

注解

如果未设置 ClientTarget 属性，则 HttpBrowserCapabilities 与 Page.Request 属性关联的 对象将反映客户端浏览器的功能。 如果设置了此属性，则会禁用客户端浏览器检测，并且页面将使用与所提供的值 (别名) 关联的浏览器功能。

Web 服务器计算机上的根 Web.config 配置文件定义了以下默认别名，你可以将其用作常见用户代理字符串的简写：

• uplevel，指定与 Internet Explorer 6.0 等效的浏览器功能。

• downlevel，指定与不支持客户端脚本的旧浏览器等效的浏览器功能。 可以使用此别名来确定网页在禁用了客户端脚本的浏览器中的工作方式。

可以使用此属性以编程方式设置别名，也可以使用 @ Page 指令的 属性以声明方式ClientTarget设置别名。

可以在应用程序级别 Web.config 文件的 节中 clientTarget 定义其他别名。 有关详细信息，请参阅 clientTarget 元素 (ASP.NET 设置架构) 。

另请参阅

• HttpBrowserCapabilities
• Browser
• UserAgent
• ASP.NET 服务器控件和浏览器功能
• ASP.NET 配置文件