ClientTarget 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
定义与目标用户代理关联的别名，ASP.NET 服务器控件应呈现该用户代理的内容。 此类不能被继承。
public ref class ClientTarget sealed : System::Configuration::ConfigurationElementpublic sealed class ClientTarget : System.Configuration.ConfigurationElementtype ClientTarget = class
inherit ConfigurationElementPublic NotInheritable Class ClientTarget
Inherits ConfigurationElement- 继承
示例
本部分提供了两个代码示例。 第一个演示如何以声明方式指定类的 ClientTarget 多个属性的值。 第二个显示如何从配置文件中获取 ClientTargetCollection 对象。 使用此对象访问 ClientTarget 它包含的对象。
下面的代码示例演示如何以声明方式为类的 ClientTarget 多个属性指定值。
<clientTarget>
<add alias=
"uplevel"
userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
<add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>
下面的代码示例演示如何从配置文件中获取 ClientTargetCollection 对象。
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
(ClientTargetSection)configuration.GetSection(
"system.web/clientTarget");
// Get the client target collection.
ClientTargetCollection clientTargets =
clientTargetSection.ClientTargets;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the <clientTarget> section.
Dim clientTargetSection _
As ClientTargetSection = _
CType(configuration.GetSection( _
"system.web/clientTarget"), _
ClientTargetSection)
' Get the client target collection.
Dim clientTargets _
As ClientTargetCollection = _
clientTargetSection.ClientTargets
注解
该 ClientTarget 类是指在配置文件的节中添加 clientTarget 的元素。
该 ClientTarget 类属于包含 ClientTargetCollection 该类和类的 ClientTargetSection 组。
该 ClientTarget 类包含两个标识客户端浏览器的属性，也称为用户代理。 一个属性是与第二个属性标识的客户端浏览器关联的别名。 ASP.NET 使用此信息在页面中呈现服务器控件。
有关如何以编程方式使用用户代理或其别名的信息，请参阅该 Page.ClientTarget 属性。 有关如何以声明方式使用用户代理或其别名的信息，请参阅 @ Page。
如果未设置该 Page.ClientTarget 属性， HttpBrowserCapabilities 则与 Page.Request 该属性关联的对象反映客户端浏览器的功能。 (它反映了浏览器类型的功能，但不一定是该浏览器的特定实例中的设置。) 如果设置了属性，则禁用客户端浏览器检测，并且页面使用与定义的用户代理字符串关联的浏览器功能。 可以将此属性设置为任何有效的用户代理字符串。
构造函数
| ClientTarget(String, String) |
初始化 ClientTarget 类的新实例。 |