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 关联的 对象将反映客户端浏览器的功能。 (它反映浏览器类型的功能，但不一定反映该 browser 的特定实例中的设置。) 如果设置了 属性，则禁用客户端浏览器检测，并且页面使用与定义的用户代理字符串关联的浏览器功能。 可以将此属性设置为任何有效的用户代理字符串。
构造函数
| ClientTarget(String, String) |
初始化 ClientTarget 类的新实例。 |
